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ta QL SCENE @ Microcassettes to roll again 
AU OPEN CHANNEL @ CritiQL! 
Sa QL SCENE @ Another new move for Minerva 
‘ay ONE PER DESK MICRODRIVES @ Conversion suggestion 
5) MDX @ Still no Microdrive Exchange yet 
J. TROUBLESHOOTER @ Disk drives and interfaces 
cau SUPERBASIC @ You did WHAT? 


LDEF FOR SUPERBASIC @ A SuperBasic extension 

MEDIA MANAGER SPECIAL EDITION @ A complete new revision 
ARCHIVE POWER @ Part One of a new four-part series 
SOFTWARE FILE @ MS-QLink 
THE PROGS @ Piping Hot 


NEXT 
MONTH 


SOFTWARE FILE: 
THE VOYAGE OF THE 
BEANO 

A new text and graphics adventure 
from Alan Pemberton. 

ONE MAN’S 

SYSTEM 


Including a Hunt routine for use in 
Archive, 


a9 


WRITTEN BY 
ALAN PEMBERTON 
GRAPHIX BY 
FRANCIS O SRIEN & 
ALAN PEMBERTON 


FRVICES 


A new offering from adventure 
and public domain publishers 


CGH Services is The Voyage of 


the Beano, a text and graphics 
adventure for OLs with 256K- 
plus of memory. 

The Voyage of the Beano 
charts the adventures of J. D. 
Hogwash, a lowly deck-hand 
and shove-ha’penny cham- 
pion, who captures a Spanish 
galleon by accident and is dis- 
patched to the New World by 
an impressed Queen Bess to 
fight the Spaniard and bring 
back the gold. 

His fate is in the hands of the 
player. 

The Voyage of the Beano is 
written by Alan Pemberton, 
with graphics by Francis 
O'Brien and Alan Pemberton, 
and is so new that OL World 
docs not have a price at the 
time of writing. Contact CGH 
Services, Cwm Gwen Hall, 
Pencader, Dyfed, Cymru SA39 
9HA for further details. 


Multiple Basic 


Minerva rom publishers 
QView are now making multi- 
ple Basic interpreters available 
with the latest versions of 
Minerva. This will make it 
possible to have multiple 
concurrently-running Super- 
Basic interpreters running on 
Minerva, a feature cxpected 
when the OL was originally 
launched, but never achieved. 

A small EXECutable job 
will now be supplied, which can 
be hotkeyed using the QJump 
Hotkey System 2: this calls a 
new vector in the Minerva rom, 
which promotes it to copy of 
the Basic interpreter. When 
invoked, a new Basic can copy 
the entire Basic name table or 
just the original rom keywords. 

Other new vectors include a 
fast memory move routine 
which, states OView, can move 
memory non-destructively (in 
the case of an overlap) at 359K 
per second, 

With the new version comes 
a price increase to £40 (£35 to 
Quanta members) with £2.50 
post and packing to overseas 
customers, printed documen- 
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tation, no further requirement 
for a rom image at time of 
ordering, and a credit card 
ordering facility on 0480 
412884. 

For orders or information 
contact QView at 29 Carnaby 
Close, Godmanchester, Hunt- 
ingdon, Cambs PE18 8EE. 


The Spring 1990 supple- 
ment to the Grecnweld 
Electronics catalogue has 32 
pages, a special introduc- 
tory digital multimeter 


offer, a free 240V ac minia- 
ture mains 15W soldering 
iron with over £20-worth of 


orders from any current 
Greenweld catalogue, 
“amazing bargains” and a 
new address, which is: 

Greenweld Electronics 
Ltd., 27 Park Road, South- 
ampton SOI 3TB. Tel. 0703 
236363. 


H.M.S. “UNSINKABLE > 
THE QL HAS SURVIVED ATTACKS FROM GREY WOLF 


AND TYPE 22. NOW THE BIGGEST CHALLENGE 
FLEET TACTICAL COMMAND 


INSIDE THIS ISSUE: 


REVIEWS OF FLEET TACTICAL COMMAND AND RETURN TO EDEN 


PLUS OUR USUAL HINTS. HELPLINE AND SOLUTIONS FOR ADVENTURI S 
‘ 
AND A SPECIAL SELECTION OF ARCADE GAME EVIEWS 


What’s in a name? 


QL ~~ Adventurers’ Forum 
(QLAF) issued 9 is now out. In 
a surprise move, the front 
cover displays the words “The 
Last Issuc!* The reason behind 
this is not the magazine's 
demise, but a change of name: 
publisher Richard Alexander, 
is relaunching QLAF as QL 
Leisure Review, to reflect the 
broader range of games, 
including arcade games, now 
appearing in its pages. 

Issue 9 contains reviews of 
Fleet Tactical Command from 
Di-Ren, Treasurer Hunt 
(public domain) from CGH, 
Brain Teaser from Jochen 
Merz, Speedfreaks from Kaos 
and Assault and Battery, also 
from Kaos, Dreamlands from 
Jean-Yves Rouffiac and Uncle 


Loony’s Legacy by the 
Watsons. Also appearing are 
solution hints to Aguanaut 471 
and Colossal Cave, news, short 
reviews, hints, and a wargames 
update. 

OL Technical Review issue 3 
is also. out and about. 
Alongside a large number of 
brief reviews are an article on 
adjusting television displays, 
comms (mainly bulletin 
boards), programming hints, 
and a considerable amount of 
topical news and responses to 
previous comments. 

OL Adventurers’ Forum is 
£1.25, and QL_ Technical 
Review, £1.50, both published 
by CGN Services, Cwm Gwen 
Hall, Pencader, Dyfed, Cymru 
SA39 9HA. Tel. Pencader 574. 


Open Channel | is a you ae the 
opportunity to voice your opinions in Sinclair 
QL World. ‘Whether you want to ask for helj 
with a technical problem, provide somebody 


1 am writing about the com-— 


ments in last issue’s Troub- 
leshooter, regarding t 
_queror PC emulator, Like ¢ 
things, it has good point 


ism being its lack of speed, It is 


comparatively slow but | con- 


sider i hee more sae. for it 


fog like myself who refuse 
to get rid of the OL for yet — 


more computer hardware 
which is not necessarily better. 
Second, | did not have the 


money to buy an IBM PC or a 
clone, so the £80 for the emula- 


tor was the ideal solution. _ 
Third, Conqueror will run all 


A few we 


complete my Openl 
sity degree this year. 


not so. Jong ago that people 
were using mainframe compu-_ 
ters; when they were used to” 
compile and link program: 
~ instance, they took far longer — 


han the emulator. 


Philip Johnson, : 


- Stoke-on-Trent, 


Staffs. 


Cub 653 monitor which I have 


i longer than I can remem- 
_ the well-behaved PC packages — 


ber. possibly about 1984-5 and 


which wa 
reason to be 
decided to call at the factory to 


ago | started to 
get multi-coloured flashes on 
the screen of my Microvitec — 


Bryan Davies is correct t 
could have made more of a 


win the answer, or just sound off about 
something which bothers you, write to: Open 
- Channel, Sinclair QL. World, 116/120 oe 
Road, London ECIV 7QD. 


8 is used for some c hours or 
most days. 


By climinating othe: causes al 
found that it was the monitor 


in Bradford, 


see what could be don 


the technician testing i 


emerged with a monitor whi 
for some weeks has been ai 
good as ever. The pot was 


installation ofan 


‘in the OL. Soe Q 
The explanation given was 


that some of the component: 


had started to pass too high a 


voltage and the tolera ce limits 
had been passed. I was told 
that the 653 is no longer made 
but that a one-off could be 


made to order at a reasonable 


splash about its spell-checker. 


It is brilliant. Perhaps it 1s not — 


clear that English, French and 
German are all supplied as 
standard, although the user 
would normally select only one 


ata time. 
_ My only slight apo is 
that the dictionary editor uses a 
window hard up to the left- 

hand edge of the OL sereen. As 


a monitor I use a television set 
with RGB which does not give 
the full width, so | have to do 
some guesswork. Of course, 

you need the editor only when 


you want to alter the diction- 
ary. 


‘On another topic, 
puzzled by your editorial 
remark in February: that micr 
cassettes are cheaper 


sat fault and, as Thad 


pence fora dise. 1 pay as little 


as £1 each for discs guaranteed . 


for life. If a dise ever fails to 


read or write then the supplier, 
Inmac, 
replacement. The reliability is 
important to me, although | 
‘ould buy more cheaply. Even 
ignore | 


sends two discs as — 


on a one-for-one basis, 
ing the huge capacity advan- 


tage of dises, they are much a 
Cee than microcassettes. 


Ken Whyld, 
Caistor, 


Lincoln, 


tor’s comment: This: is My 


take. 1 use branded 3.5in, 
discs. and buy by the box. 


Through a combination of 


good housekeeping and cadg- 


ing the odd disc from my parl- 


ner, | have not had to order — 


another box of discs for along — 


time. Last time | ordered it cost 


1 £40 for abox of 10. That will 
ive you some idea of the time 


2. The price of 3.5in, dises has — 


fallen dramatically since then. | 


o much of my professional 
ork on 


them are still advertised at — 


between £2 and &4 each, 10-off, 
5.25in. dises are the cheanes 


Your editorial in the Mar 


1990 issue of OL World invited 
comment from readers con- | 


cerning the relative amount of 


editorial matter in the maga- 
zine, compared to that obtain 
ing, say, two years ago. T woulc 


suggest that OL World is sill _ 
the only important source of | 
further 


information on th 
internal arrangement and fun 
tioning of the 150,000 QLs 
ich were sold. It is also th 
eral source of information 
about spares, programs and 
twice, for an exceedingly use: 


company-owned 
mstrad PCWs and discs for 


instrument, so that the amount 
of editorial matter in it is not 
necessarily the factor upper- 
most in the minds of all pur- 
chasers, though it is important 
to many. 

Sales as high as 12,400 copies 
monthly surely confirm that 
view. They mean that one in 
12, roughly, of all OL. owners 
buy the magazine, The 
unknown is, of course, how 
many OL owners are active, in 
the sense of needing more than 
the basic 128K computer and 
software originally supplied, 
and hence, further equipment 
and/or servicing information. 

In the absence of facts, one 
must assume, — statistically 
speaking, that the figure is 50 
percent, so it must be that 
about one in six active users are 
buying OL World, Even that is 
probably a pessemistic esti- 
mate, since a fair fraction of the 
QLs sold went overseas. This 
must represent continuing 
good acceptance and acknow- 
ledgyment of the magazine by 
any normal commercial stan- 
dards. 

The number of pages is 
important, I suppose, to con- 
vince some people that they are 
getting value — but far more 
important is the usefulness of 
their content. In that respect, 
recent articles have seemed 
more and more to acknow- 
ledge that, while expensive, 
purchased programs in 
machine code are, one assu- 
mes, the ultimate luxury in 
trouble-free computing, 
SuperBasic programs can be 
made to do as much, even if a 
little more slowly, for those 
who are not ina panic to see the 
result. It is articles such as 
Simon Goodwin’s Taskforce 
facility which make the maga- 
zine so welcome and boost its 
sales. 

L.G.L. Unstead-Joss, 
Edinburgh. 


I have keyed-in Skyvburst from 
the February, 1987 issue in the 
belief that because it has check- 
sums on each DATA line it 
would work if it showed no 
errors. That, however, seems 
not to be the case. As soon asa 
missile strikes one of the 
‘invaders’ the program locks 
up. requiring the OL to be re- 
set to regain control. 
Two-and-a-half years later, 
do you have any record as to 
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the nature of the fault? It 
occurs to. me that it may have 
been written for a 128K 
machine and mine is expanded 
to 640K. Any help you can 


provide would be much appre- 


ciated, 
Stuart Winnall, 
376 Carterknowle Road, 
Sheffield, 
South Yorkshire S11 9GD. 


Editor's comment; The author 


of Skyburst was Simon Oven- 
ston, whose address is appa- 


rently no longer in the files. If he 


is reading this, or if anybody 
can shed light on the problem, 
could they please get in touch 
with the writer? 


Browsing through my collec- 
tion of your wonderful maga- 
zines I noticed the Screen Stor- 
age toolkit in the September, 
1987 issue. I typed it in and 
have created some simple but 
fairly impressive animations 
with the new commands, 

The animations [ have done 
so far have required each frame 
to be drawn out by Basic first 
and then stored as machine 
code in memory by the 
G_SAVE command = each 
time the animations are run. 

That is not very convenient, 
as it makes the program very 
slow, especially with compli- 
cated vector images. [have had 
to do this because there is no 
reference to the saving of the 
code produced by the new 
commands. Therefore could 
you explain how to save the 
code produced and how to 
reload it so that the G_LLOAD 
command can be used to pro- 
duce the animations without 
having to go through the pain- 
fully slow Basic drawing of it all 
first? 


I would also like to know if 


there are any video digitisers 

available for the OL and the 
address of the supplier. 

G. Ayre, 

Gainsborough, 

Lincs. 


Editor's comment: We willlook 
into the animation question. As 
for the digitiser, TK Computer- 
ware was the agent for the 
SPEM digitiser; we are not sure 
of the status of this at the 
moment but TK may be able to 
advise you; see Instant Access 
on page 50 for the telephone 


number. — 


April's edition of OL. World 
was prey to more misprunts 
than usual, especially on the 
Open Channel pages, 

A letter from Christian 
Caris, appropriately headed 
‘Confused’, seemed to suggest 
that he is in the process of 
having the Editor sued (sic) for 
serious word processing. Mr 
Caris should know that his 
litigation has no chance if Ms 
Armstrong uses Quill, 

In Troubleshooter, Bryan 
Davies rightly takes to task 
certain ads for OL Organiser 
for not mentioning the need for 
a £60 interface. The advertisers 
say that users will become 
aware of that when they read 
the manual, but by then they 
will have bought the Orga- 
niser, won't they? 

The computer industry is not 
alone in concealing the true 
cost of advertised goods and 
services (“Ex. WAT” isa 
favourite), Mr Davies does 
well to draw our attention to 
this. 

Mike Lloyd gives us an 
interesting article about Desk 
Top Publishing, a subject 
which seems almost as jargon- 
ridden as computing. His piece 
is about layout and he does not 
mention the sheer hard work 
required by the reader to 
decipher the small print. My 
eyes are fairly efficient if | wear 
my specs, but I find most DTP 
literature very tiresome to read 
~~—not least the efforts of one or 
two of your best advertisers. 
Digital precision is not enough 
you've gat to be able to read 
DTP without resorting to a 
magnifying glass. And all DTP 
looks dreadful to my eyes. 

No Simon Goodwin this 
month. Pity, especially as in 
March’s issue he said he would 
return to the subject of his 
ingenious Multibasic routines. 
Mr Goodwin’s articles are 
always worth reading, but his 
hexloader would save me a lot 
of work if he could find a way of 
distinguishing between letter 
*B’ and integer ‘8’ in his hex 
DATA statements. Would it 
not be possible to print (say) 


“X’ for B’ and have the loader. 


do the necessary conversion to 
decimal 11? It would save a lot 
of ‘Checksum incorrect’ messa- 
ges. 

A similar difficulty emerges 


when typing-in SuperBasic 
programs. Some programmers 
expect me to type strings of 
spaces which, by their very 
nature, are invisible. Could 
they consider inserting REMs 
at the end of offending lines to 
give the number of spaces in 
their strings? Or perhaps they 
could try PRINT FILLS ("",20) 
which will print 20 spaces with | 
no bother at all. And we'd all 
be saved trying to count them. 

M T Edwards’ Code Breaker 
program is interesting, but | 
wish he had this kind of regard 
to ‘typing-in’ problems, He | 
also defined a WINDOW#2 
(ling 330), which makes it 
impossible to correct typing: 
errors after a RUN because the 
LIST command defaults to 
channel 2. 1 had to write a 
PROC to re-define the default 
screens in order to edit his 
program. Not a difficult task, 
but he could have used another 
channel for his WINDOW#2. 

I'm going to start a Society 
for the Encouragement of User 
Friendly Listings, with severe 
penalties for those who trans- 
gress, 

Finally, let me attempt to 
answer K. Plummer’s printing 
problem which is posed in 
Open Channel. Could it be that 
he is forgetting to ENTER 
‘BAUD 1200 (or whatever his 
baud rate happens to be) 


before “OPEN#3,serl’ and 
‘LIST#3°? 1 am always omit- 
ting this. 


Even when | remember the 
baud rate, I forget to switch the 
printer on! 


C.B. Storey 
Tyne & Wear | 


How wise your suggestions are, 
CB, and how kind of you to 
blame the 8s and Bs on Simon's 
cruel printer rather than my | 
own, Perhaps a magnifying 
glass is the best answer, We 
can't print them much larger 
without larger pages. 
Advertisers should not expect 
their customers to read the | 
manual (hefore or after purch- | 
ase), It is true that the manual | 
may hold a wealth of valuable 
information (as well as revela- 
tions about expensive add-ons, 
but why fly in the face of 
experience? ie 
My imminent suage would 
appear ta be a perfect example 
of computer-checked English: 
it makes perfect sense, as long | 
as you don't know what it 
means. 


i 


Microdrive stocks saved? 


EEC Ltd., suppliers of new 
boxed OLs, OL hardware, 
microdrives and cassettes and 
dise drives to the QL and 
Spectrum community, have 
contacted OL World to say that 
they have “plenty” of OL and 
Spectrum Plus 2 and Plus 3 
microdrive cartridges, “and 
foresee adequate stock of hard- 
ware for at Icast 12 months, 
and spares for two to three 
years, including Microdrive 
cartridges.” 

Bill Richardson, EEC’s 
managing director, says “The 
QL demand is still good. We 
have sold over 400 machines in 


QL in 
Italian 


OL Italy is a public domain OL 


disk magazine published in Ita- 
lian, The disk will run on any 
QL with at least one 720K disk 
drive and is “packed full” of 
QL-related items, Nine issues 
have been published since Feb- 
ruary 1989, and QL Italy is 
aiming for bi-monthly publica- 
tion. Typical contents include 
reviews, articles, programming 
information, small programs, 
demos and utilities, letters and 
other comments. Scanned 
screen shots are taken from 
commercial programs to give 
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the last twelve months and 
have plenty in stock. These are 
still new machines, brought up 
to date with roms and software. 
We have large stocks of Mic- 
rodrive cartridges to support 
our customers and confidently 
expect continuing supplies to 
become available. We also 
have lots of spares.” 

EEC has pledged its con- 
tinuing support for OL World 
and Quanta, and appeals to QL 
World in its turn to continue to 
support OL users. EEC is 
offering a free one-year mem- 
bership of Quanta to any cus- 
tomer spending over £100 with 


the prospective buyer a look at 
what the program offers. 

QL Italy is available for the 
cost of the disk and postage: 
5,000 Lira in Italy, 6,000 Lira 
(a bit under £3) in the EEC; 
users living outside the EEC 
should send a stamped self- 
addressed envclope or IRCs 
for information. The address 
for orders and information is 
QL Italy Group, c/o Eros Fore- 
nzi, via Valeriana 44, 23010 
Berbenno (Sondrio), Italy. Tel. 
(Italian local) 0342 492323. 


Another publication avail- 
able in Italy is News-Ware, the 
bulletin of Club-Ware, estab- 
lished as a OL club in Italy 
since 1987. News-Ware is a bi- 
monthly magazine composcd 
using fext*’, containing news, 
reviews and articles on specific 
topics. Membership of Club- 
Ware gives access to the news- 
Ictter, support advice and a 
public domain software lib- 
rary. Annual membership 
costs 25,000 Lira, paid to Club- 
Ware, c/o Roberto Orlandi, via 
Brescia 26, 25039 Travagliato 
(Brescia), Italy. Tel. (Italian 
local) 030 6863311. 


EEC. Bill Richardson has also 
spoken to QL Microcassette 
manufacturer Ablex’s MD, 
Peter Banks, recently, 
Richardson believes that there 
is a very substantial stock of 
mechanical parts for the car- 
tridges in existance, and that 
supplies of suitable tape should 
become available in May or 
June. 

At Ablex, Peter Banks con- 
firmed that he had located 
supplies of tape at German 
tape giant, BasF, similar to that 
previously in use in the Micro- 
cassettes. He had samples 
already in hand and production 


tests were due to begin in late 
April. 

The high-quality video tape 
used to construct the 
continuous-loop Microcassette 
tape is unusual in that it is 
neither lubricated in the nor- 
mal manner of continuous loop 
tape, nor has the coated back- 
ing used by most videotape to 
give reliable tracking charac- 
terisitics. “We and_ Sinclair 
investigated the original tape 
requirements together and 
found that videotape had suffi- 
cient record quality but the 
normal lubrication or coated 
backing would foul the micro- 
drive tape heads in time, so we 
had to find a tape with a shiny 
backing.” 

Sample tape with shiny back- 
ing is now with Ablex. 


Enthusiasts hunting for bargains at the All Formats Computer Fair. 


Fun of the fair 


The second All Formats 
Computer Fair on April 28 and 
29 was arranged in ‘villages’ for 
many of the more popular 
specialist computers, including 
the OL, Z88 and SAM Coupe. 
The following fair, which is to 
be held on June 9 and 10, will 
have Archimedes and MSX 
villages. 

Like the Z88, the Archimedes 
appeared on the market in the 
samc generation as the Atari ST 


but failed to make the impres- 
sion which the ST and before it 
the IBM PC made on the home 
and small business computing 
market. 

The electronic magazine 
Micronet is expected to be on 
line at both fairs. The site is 
again expected to be the New 
Horticultural Halls, near Vic- 
toria Station, London. Phone 
Bruce Everiss on 0926 640137 
for further information. 
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Dennis Briggs 
outlines the 
connections to 
reuse One Per 
Desk 
microdrives. 


Qu 
Edge 
Connector 
Al RAW 1 (DATA 1): 

A2 MDSELCKN 


A3 | POLARISING SLOT 


Ad. MDOSELDH 


FUNCTION 


AS ERASE 

A6 GND 

Al GND 

AB GND 

B1 RAW 1 (DATA2) 
B2 nc. 

B3 [POLARISING SLOT] 
Ba. VIN 

BS MDWRL 
B6 GND 

B] GND 


GND 


14 


Figure 1. Connections between the QL and One Per Desk. 


D TO QL 


ne of the long-term problems 

with the QL is the reliability of 

the Microdrive units. Before 

owners tell me that theirs are 
satisfactory, consider the fact that prog- 
rams have appeared which will make 
back-ups of protected cartridges so that 
the program is not consigned to the 
dustbin if the Microdrive will not read it. 
One of the main reasons for failure is 
the extremely hot heatsink next to the 
Microdrive ULA which causes it to lose 


OPD FUNCTION 


1 MDSELCLK 

2 MDSELD 
3——— RAW (DATA 1) 
4. GND 

5 ——— RAW 2 (DATA 2) 
6 GND 

7 MDRWL 

8 GND 

9 GND 

10 5 VOLTS 

1 PROTECT SO pee 
12-————— 12 VOLTS 

13 NOT USED 


14 ERASE 


14 WAY 
IDC EDGE 

RIBBON 
CONNECTOR CABLE 


PLUG INTO 
Qk 
MICRODRIVE 
PORT 


Figure 5. Connector assembly.. 


Figure 3. Stylised connection diagram. 


performance over a period of time and 
read/write heads which wear out. 

The Microdrive units can be changed or 
repaired at a price; also many owners with 
disc drives just want the facility to read or 
write to a tape on rare occasions. This an 
omission on the Thor XVI. 

ICL manufactured One Per Desk or 
Tonto computers used Microdrives 
together with the 68008 chip and the two 
QL ULAs but very little else. Those OPD 
modules containing two Microdrives are 
available for about £5 per module, so it is 
worthwhile considering fitting them as a 
plug-in expansion to the QL. 

Top overcome any problems we have 
used Page Designer 2 and a professional 
artist to produce the connections, a 
stylised PCB overlay and a double-sized 
PCB overlay. With a little good fortune the 
PCB overlay should be printed actual 
size. 


14 PIN HEADER 
FOR OPO 
CONNECTION 


16PIN HEADER FOR GL CONNECTION 
Figure 4. The connection overlay. 


Ale 2» 14 WAY RIBBON CABLE _ 
TO“ODP.MICROORIVES 4 
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iracle Systems have develo- 

ped an adapter to enable 

users of older versions of the 

Trump Card to connect three 
or four floppy disc drives to their systems 
(the previous limit was two). The adapter 
plugs into the output connector on the 
Trump Card and has two similar connec- 
tors at its output end. Standard one- or 
two-drive ribbon cables can be plugged 
into both connectors. The unit is about 5x 
5cm. A new rom chip is supplied for the 
Trump Card. The price is £15. With the 
advent of PC emulators, and a variety of 
file transfer programs, some users will 
certainly appreciate being able to have 
separate pairs of 51%4in and 3¥2in drives 
connected to their system at the same 
time. 

The current version of the Trump Card 
is different in several ways from the earlier 
one. It does support four floppy drives 
directly but they must be daisy-chained to 
the one output connector. The memory 
chips fitted are 8Ons, 1MB dram types (but 
maximum capacity is still 769KB), with the 
result that there is a lot of spare space on 
the pcb, and memory accesses are now 
much faster; the TC should now rank with 
the old CST interface, having memory 
access as fast as it can be on the QL. 
Another advantage of the new chips is 
lower power consumption; this, along with 
some redesign of the circuitry, should 
result in few problems with lockups. The 
new feature likely to appeal most to 
prospective purchases is the drop in price 
to £225 for the full 768KB version. 


No high density 


In answer to some possible questions, 
Miracle state that they considered 
developing a high-density drive interface, 
but have — for the present — dropped the 
idea. Such an interface would have 
required a different drive chip from the 
WD1772 usec in the Trump Card and, 
presumably, the driver software would 
have to be rewritten to cope with 1.2/1.44 
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RONUIGRINE 


Improvements in the Trump Card and other news about Miracle 
Systems, and an introduction to some good new programs from 
Bryan Davies. News from Troubleshooter’s investigations into 
readers’ commercial queries is less encouraging this month. 


MB. As regards producing a hard disc 
interface on its own, for users who prefer 
to provide their own drive, Miracle feel that 
the potential problems far outweigh any 
possible profit; that is, the letters and calls 
they would get from users experiencing 
difficulties getting their drives to work 
would take far too much time to deal with. 
With their present policy of supplying only 
the complete hard drive system, Miracle 
point out that users have a clear guaran- 
tee of support, whereas the only support 
for an interface alone would be its repla- 
cement in the event of it being defective. 
In view of the variety of hard drives for 
sale, and the uncertain state of software 
which could be used to drive them, this 
view seems very sensible. 


Tandon drives 


Potential purchasers of the hard disc 
system who have noted the adverse 
comments about Miniscribe, the hard disc 
manufacturers, will be glad to know that 
Miracle use Tandon drives, which are 
produced by the drive-making arm of 
Western Digital, a well-known drive con- 
troller and chip company. Miniscribe looks 
like continuing as part of the Maxtor drive 
company. The speed with which the drive 
feeds the screen with a series of 32KB 


“The Miracle 
Systems adaptor 
enables users of 
older versions of the 
Trump Card to 
connect three or four 
floppy disc drives to 
their systems...” 


screen dumps in a demonstration routine 
used by Miracle is certainly impressive. 
The Midi music interface that was 


supplied briefly by Miracle is thought to be 
undergoing a software revamp and may 
be made available again. 

Software®” have been developing an 
Italian version of text®’”, and it should be 
available about now. Not surprisingly, the 
French and German versions took a little 
longer to complete than the English 
version, and Software®’ apologise to any 
overseas buyers who experienced 
delays. Potential buyers who are still 
hesitating because of the adverse com- 
ments about the early version of the 
program should talk to people with the 
later versions, because the user interface 
is now good, and reliable, and the latest 
manual is much more comprehensive. 
Incidentally, in case any readers are 
confused about Terry Harman's involve- 
ment with Software’, he has no direct 
connection with them at all, but does offer 
an independent help line service for 
text®”, Users who feel they need assist- 
ance in learning how to use text?” can 
contact Terry and negotiate a support 
deat with him. 

The small Portuguese supplier Qfile is 
offering a program for transferring files 
between MS-DOS and QDOS, for the 
princely sum of £12. MS-QLink 1.3 pro- 
vides a variety of functions in addition to 
file transfer, such as formatting MS-DOS 
and QDOS discs, erasing files, copying 
complete discs either way between the 
two formats, and directories of both 
formats. A review of the program should 
have appeared by this time. 

A review of Media Manager Special 
Edition should be appearing. And it won't 
be a short one. By and large, I'd steered 
clear of investigating problems with discs 
and cartridges for the past year or two, 
because the subject seemed too compli- 
cated to be covered in the relatively small 
amount of time | was willing to devote to it. 
On the other hand, necessity forced me to 
understand and make use of disc utilities 
on the PC; to be honest, those programs 
were much easier to use than the original 
Media Manager, which was the only 
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obvious program on offer for the QL. 
MMSE has altered the situation. The 
considerable time spent with the program 
to write about it, and the much-improved 
user interface, have revealed the program 
as a pleasure to use, rather than a fight, as 
was the case with the initial version. It is 
not now necessary to have a degree in 
assembly language programming and 
electronics theory to be able to retrieve 


“Some of the more 
enterprising smaller 
suppliers are looking 
for buyers of their 
lines, and there may 
be changes of 
ownership before 
long...” 


lost files. It is also quite interesting to use 
the program just to see how information is 
stored on disc or cartridge. 

Readers who feel strongly enough 
about things they would like to see 
incorporated in the magazine should write 
now. This is a time when the approach to 
the magazine is being reconsidered, and 
we are being asked to make suggestions 
about improving the format and content. 


Court action 


There has been a report that the S.U.B. 
Post Office box number was “out of 
action”, but a subsequent check revealed 
that it was still in use. However, Miracle 
systems have now obtained a High Court 
judgement against S.U.B. for a substan- 
tial sum of money, and it is possible that 
this will force S.U.B. to suspend opera- 
tions completely. Manolis  Christ- 
odoulou wrote from Greece, to say that 
he ordered a SPEM kit and keyboard from 
S.U.B. in September 1988 and had not 
received it as of February 1990. There 
seems little doubt that he will not now get 
what he ordered; it seems unlikely that the 
SPEM company would supply goods to 
5.U.B. even if the latter are dealing with 
outstanding orders. | can only suggest 
that Christodoulou writes to the local 
Durham Trading Standards Officer (see 
Information) and gives details of his 
complaint. On a more positive note, 
Melvyn Hiller has received two postal 
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IROKORTSES 


orders in refund for the A4 paper not 
supplied to him; he had written threaten- 
ing Small Claims Court action if no refund 
was made. 


Market search 


Some of the more enterprising smaller 
suppliers on the QL scene are looking for 
buyers of their product lines and it is 
possible there will be announcements of 
change of ownership of certain products 
before long. Most of the products on offer 
are thought to be insufficiently developed 
as they currently stand, so there may be 
delays of some months before they 
reappear, in improved form. However, at 
least two major titles are expected to be 
handled by a different supplier shortly. 

Jeff Wass wrote (mid February) to say 
he has been unable to obtain the 2.38 
version of Archive and the Psion printer 
installer from PDQL, despite supplying a 
disc, and making several ‘phone calls to 
enquire about the orders placed in 
November '89.. There have been other 
similar complaints in past months, 
concerning slowness in dealing with small 
orders, but no complaints concerning 
orders for more expensive goods. 

J.P.S. Pennycook asked for the details 
of connection used by John Acielo in his 
“boxed QL” (see One Man's System in 
the January 1990 issue of QL World). The 
table that should have appeared with the 
article is this one: 


SLOT LINE--> SPO SP1 SP2 SP3 


0 0 0 0 0 
1 0 0 0 1 
2 0 0 0 1 
...andsoon,to... 

15 1 1 1 1 


The “O" indicates 0 volts (ground/earth 
connection) and “1” indicates +5 volts in- 
series with a 1kohm resistor. Adman 
Services can supply an unbuffered 64- 
way adapter for the QL expansion port, 
with a variable number of output connec- 
tors to suit users’ requirements. 
Norman A. Larkin reports having prob- 
lems with a PS/2 keyboard purchased 
rom Sché6n in the middle of last year. He 
says he has not had a working QL for ten 
months, since getting the keyboard. Num- 
erous calls to the suppliers have pro- 
duced neither a refund nor a working 
system. As of early March this year, the 
keyboard and QL have apparently been 


with Schon. My information is that Schén 
have been generally uncontactable for 
the past few months and have not been 
actively trading. As in all such cases, the 
options open to the unfortunate purchaser 
are few: a letter sent by a_ solicitor, 
demanding return of the goods or a refund 
within a short period, is worth trying. The 
local Trading Standards Officer for the 
district the supplier trades from (see 
Information) should be contacted, and 
given all details of the complaint. A claim 
can be made through a Small Claims or 
County Court, but the court may have to 
be in the supplier's area and that is far 
from where Mr Larkin lives (see Informa- 
tion for suggested Court to contact). This 
is however worth making enquiries about 
at his local CAB or county court. The 
expenditure on such actions could run up 
to about £50, plus a certain amount of 
time. Costs should be recoverable for a 
simple court action. The more compli- 
cated the complaint, the more compli- 
cated it is to recover costs. 


Information 

Hard disc system £449, 4-disc 
adapter £15, new Trump Card £225: 
Miracle Systems, 25 Broughton Way, 
Oshaldwick, York YO? 3BG 

Tel:.0904. 423986 

text’ v3.00 English/Italian/German/ 
French versions £60: Software®’, 33 
Savernake Road, London NW3 2JU. 
text independent support service, 
including tutorial disc: Terry Harman 
Tel: 0604 842875 

MS-QLink £12 .(5%4" or 34" disc only 
payment by sterling cheque): Ofile, 
Apartado 2110, 1103 Lisboa Codex, 
Portugal. 


_ Unbuffered 64-way adapter: Adman 


Services, 53 Gilpin Road, Admaston, 
Telford, Shropshire TF5 OBG. 

Tel; 0952 255895. 

Trading Standards Officer for Surrey: 
P.G. Harris, County Trading Standards 
Officer, Trading Standards Department, 
Mount Hill, South Street, Epsom, Surrey 
KT18 7PT. Tel: 03727 40401/9. 


County Court for Surrey: The Chief 
Clerk, Epsom County Court, The 
Parade, Epsom, Surrey KT18 5DN. 
Trading Standards Officer for 
Durham (South): M. Horner, Divisional 
Trading Standards Officer, Consumer 
Protection Department, Town Hall, 
Darlington, Co. Durham DL1 5QY, 

Tel! 0325°380651. 


Of all the SuperBasic topics the one which 
perhaps generates the most enquiries is 
the WHEN keyword. For a large number 
of QL owners their first enquiry is: “When 
did SuperBasic include a WHEN that 
worked?,” because up until the JS and 
MG roms WHEN was not implemented at 
all, even though it was a reserved 
keyword. Even in JS roms, which must 
now be the most commonly-used variant 
in the UK, the WHEN construct does not 
work reliably or safely. Its less anti-social 
habits include reporting a “bad name”, 
interpreting the WHEN block twice and 
tefusing to cancel the WHEN condition. At 
its most virulent, WHEN can lock up the 
QL to the detriment of your program and 
ultimately your sanity. 

Given its unwelcome reputation, how 
can WHEN be used with any degree of 
safety in SuperBasic programs? For own- 
ers of Tony Tebby’s Too/kit and for the 


question. 


increasing number of QL users who have 
migrated to the Minerva eprom the 
answer has already been implemented 
because both products rewrite parts of the 
incomplete WHEN code. Minerva and 
Super Toolkit2 are completely compatible 
with each other, which is just as well 
because they are very different products 
with complementary roles to play. Both 
solutions provide a valuable addition to 
the SuperBasic language. 

Readers with JS or MG roms but 
without Super Toolkit2 can experiment 
with WHEN processing but the results are 
likely to bring them grief. The main 
problem lies in escaping from a WHEN 
clause after it has been triggered. The 
END WHEN statement does not clear the 
error processing flag so that everything 
done after an error is considered by the 
interpreter to be part of the WHEN 
structure. As soon as a second error is 


Ls FILE-RELATED SINCLAIR QL ERROR CODES 


VAL CODE 


ERR_NF 


MESSAGE, MEANING and CURE 


Not found - a SuperBasic device, usually 


a drive, cannot be found (eg DIR mdv9_). 
CURE: Request new drive name and try 


again. 


Already exists - caused by trying to 
create a file using a filename already 
used on the disk or microdrive. 

CURE: request new filename and try again. 


In use ~ caused by trying to access a 
file which is already linked to another 
channel, eg OPEN_IN#S, FLPi_FILE: OPEN#7, 


FLP1_FILE. 


CURE: request new filename and try again. 


End of file -— caused by trying to obtain 
input from beyond the end of a file. 

(See Figure 3 for another cause.) 

CURE: exit data-reading loop, close file. 


Drive full - caused by trying to write to 
a microdrive or disk which has 
insufficient room for the new data. 

CURE 1, if you are creating a new file: 
Delete partially-complete file, request 


20 


When do we get a WHEN that 
works in SuperBasic? Mike Lloyd 
answers this often-asked 


spotted the computer is likely to hang or 
respond unexpectedly to statements 
typed into the Command Window. 

With Super Toolkit or Minerva in place 
all these problems disappear, allowing 
the WHEN keyword to be used in two 
distinctly different ways. In the first format, 
WHEN is followed by a condition involving 
a variable, rather like an IF statement. No 
matter where in the program the variable 
value is changed the interpreter will see if 
the WHEN expression has become true. If 
itis true then the commands following the 
WHEN line are executed until the END 
WHEN statement is met, following which 
control returns to the statement following 
the one which prompted the jump. 

An example of the first type of WHEN 
structure is: 


100 WHEN print_line > 22 
110 CLS: print_line = 0 
120 page= +1 

130 END WHEN 


Exactly the same functionality could be 
obtained using a GOSUB statement after 
every statement in which the variable 
print_position is changed, rather like: 


200 print_line = print_line + 1 
210 GOSUB 5000 


5000 IF print_line > 22 THEN 
5010... etc etc 
5090 RETURN 


The GOSUB solution is clumsy, slow and 
unattractive. With the WHEN keyword 
you can safety forget about including 
GOSUB statements (which you will know 
by now are rather disliked by this col- 
umnist) and writing extensive subrouti- 
nes. Programs can contain many WHEN 
clauses of this type and all can be active 
simultaneously, although there may be 
problems if more than 20 clauses are 
defined at once. 

The most important rule for using 
WHEN clauses is that the WHEN block 
must be scanned by the interpreter during 
the running of a program before it can 
respond to any change in a variable value. 
The interpreter sets markers on first 
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reading a WHEN clause but it does not 
carry out the commands within the WHEN 
structure at that stage. Only when the 
WHEN condition becomes true after the 
clause has been scanned does the inter- 
preter action the statements between the 
WHEN statement and the END WHEN 
statement. It is therefore usual to place 
WHEN clauses near to the beginning of 
programs. 

There is no rule to prevent WHEN 
blocks from being declared within a 
procedure or function, or for the “WHEN 
expression" variant to call procedures or 
functions from within the body of the 
structure. The following arrangements 
would be considered good programming 
practice: 


1. Placing “WHEN expression” state- 
ments in the main body of the program 
before any procedures or functions are 
defined. 

2. Placing “WHEN expression” state- 
ments in an initialising procedure called 
early in the program’s run. 

3. Placing a "WHEN expression” state- 
ment in a function or procedure definition 
in which it is uniquely used. 

4, Placing one or more WHEN statements 
in a subroutine (if you really must use 
them). 


Careless programming style can lead 
to problems when developing or amend- 
ing programs and, at worst, might jeopar- 

_dise the program during runtime. Things 
to avoid when using either of the WHEN 
variants include: 


1. Nesting WHEN statements inside each 
other or inside FOR..NEXT or REPEAT 
loops. 

2. Placing a WHEN statement in one 
procedure or function definition when the 
variable which activates it is amended 
only by another, unrelated, definition. 

3. Placing WHEN structures in “dead” 
program areas which the interpreter 
never visits. 


The conditional expression in a WHEN 
statement can be any valid SuperBasic 
expression, such as: 


WHEN x = 34 

WHEN y > 17 

WHEN z$ = “flp1__” 

WHEN h>40ORh<2 
WHEN Y = 12 AND an$ = “Y” 
WHEN xyz > abc * def 


The expression syntax is exactly that 
allowed in IF statements. As the last 
example demonstrates, variables can 
appear on both sides of the equation and 
the current variable values are used to 
calculate the truth of the expression. 
However, all variables appearing on the 
right hand side of the expression must 
have some value assigned to them before 
the WHEN clause is encountered by the 
interpreter, ie: 
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new medium, try again. 

CURE 2, if you are appending to a file: 
Close file. If possible read whole file 
into memory, trim any incomplete line, 
request new medium and save afresh. 


Bad name —- caused by an invalid filename. 
(See Figure 4 for another cause.) 
CURE: request new filename and try again. 


Bad or changed medium - either a medium 
has been removed with files still open or 
the medium has become corrupted, 

CURE: request insert medium, try again. 
If process fails again, report error. 


Read only - caused by trying to write to 
or delete from a read-only disk or mdv. - 
CURE: request medium be adjusted or 
replaced to allow files to be written. 


2. CHANNEL—RELATED SINCLAIR QL ERROR CODES 


(Prisarily for soa-file-related channels, such as vindows and pipes) 


VAL CODE MESSAGE, MEANING and CURE 


-5 ERR_BO 


Buffer full — caused by reading too 
many characters into an I/O buffer 
without an ‘end-of-line' code. 

CURE: remove characters from head of 
buffer (eg by LET input$ = INKEY$(#7)) 
before resuming input. 


Channel not open — a reference was made 
to a non-existant channel, or (rarely) 
a channel could not be opened. 

CURE: alter program to remove incorrect 
channel reference. 


In use - caused by trying to access a 
file which is already linked to another 
channel, eg OPEN_IN#5, FLP1_FILE: 
OPEN#¥7, FLP1_FILE. 
CURE: alter program to remove conflict. 
Xmit error - a transmission error has 
been discovered affecting SER! or SER2. 
CURE: try again a few times, then abort 
and report error. 


Bad parameter - can occur when trying 
to read data from a write-only device 
such as a screen window. 

CURE: change program to remove error, 


3. GENERAL RUN-TIME SINCLAIR QL ERROR CODES 


VAL 


-1 


CODE 
ERR_NC 


MESSAGE and MEANING and CURE 


Not complete - usually occurs if 
CTRL-SPACE has been pressed. To avoid 
obvious problems, CTRL-SPACE cannot be 
trapped by a WHEN clause. 


Out of memory — no more RAM space. 
CURE: if possible, remove unwanted 
programs, large arrays, long pipes or 
RAM disks, but in practise this error 
is usually fatal. 


WHEN ERRor 
IF ERR_XP 


PRINT#0;ERNUM!!: 
"Try again." 
RETRY ERLIN 


PRINT#O; 
ELSE 


REPORT 


PRINT#HO;"Unexpected error ("; 


PRINT#O; ERNUM; 
"on 


PRINT#O ; 
STOP 
END IF 


END WHEN 


my Ws 


line "; ERLIN 


REMark demonstration 


CLS: PRINT "Type 
invalid 


PRINT "(Try 
FOR x = 1 TO 5 


in @ number" 
input too)" 


AT 10,5:CLS 3: INPUT num 


PRINT x3"/5 
END FOR x 
STOP 


100 LET Xpos = 0 

110 WHEN WinWidth > 512 — Xpos 
120 WinWidth = 512 — Xpos 

130 END WHEN 


Unfortunately, the value of the variable on 
the left hand side of a WHEN expression 
can be changed without triggering the 
WHEN test by passing it to a procedure 
definition, such as: 


200 Double WinWidth 

210 DEFine PROcedure Double (WW) 
220 WW = WW ‘2 

230 END DEFine 


This feature is best considered to be a bug 
because it does not conform to the rule 
that SuperBasic parameters are passed 
by reference, in other words that any 
change made to a formal parameter 
inside a user definition affects the equiva- 
lent actual parameter outside the defini- 
tion. In the example above,no matter what 
value is assigned to WW, and hence to 
WinWidth, the WHEN clause will not be 
triggered. 

As with SuperBasic's other low-level 
structures, single-line WHEN statements 
are permitted in which the END WHEN 
statement is optional. A useful addition to 
the WHEN syntax allows WHEN proces- 
sing to be cancelled by following the 
WHEN keyword with the appropriate 
variable name, so that: 


WHEN print_line 


will cancel all WHEN processing involving 
the variable print_line. 


The “WHEN” variable = expression” 
construct is best treated as a powerful 
type of subroutine, and subroutines do not 


correct" 


mix easily with the hierarchial structures 
provided by the DEFine PROcedure and 
DEFine FUNction statements. Care 
should always to taken to ensure that the 
effects of a WHEN clause being triggered 
are predictable and controllable. My own 
preference is not to use a “WHEN 
expression” clause unless there is no 
practical alternative, which means that 
they very rarely occur in my programs. 

The second version of the WHEN 
clause opens up much more spectacular 
possibilities because it allows program- 
mers to trap, check and respond to errors 
without bringing a SuperBasic program to 
a premature and unwelcome halt. With 
this WHEN variant, any error occuring 
after the clause has been scanned will 
cause the interpreter to action the state- 
ments within the WHEN block. 


The basic syntax of the second WHEN 
variant is: 


100 WHEN ERRor 
110 PRINT #0, “Whoops!” 
120 END WHEN 


The main body can, of course, comprise 
any number of valid SuperBasic state- 
ments. 

There are two important differences 
between the “WHEN ERRor” variants. 
Firstly, although programs can have more 
than one WHEN ERRor clause only the 
one most recently scanned will be 
actioned in the event of an error occuring. 
Secondly, Tony Tebby reports that it is 
unwise to call user-defined procedures 
and functions from within a “WHEN 
ERRor” clause. 

To help with error processing, a number 
of extra SuperBasic keywords have been 
implemented. Over 20 functions have 


been declared, each one relating to one of 
the possible QDOS error conditions. 
Unlike all other functions in SuperBasic, 
the error code functions are not followed 
by brackets. To use them, something of 
the way in which QDOS handles errors 
must be known. 

After interpreting every statement, 
QDOS issues an exit value which is 
ignored if the statement is actioned 
successfully. If, however, an error is 
detected the exit value is set to a negative 
number which identifies the sort of fault 
which QDOS has detected. These values 
can be seen, together with the function 
name and the error messages which they 
produce, in the accompanying tables. 

The tables are based on groups of 
errors which are likely to occur in given 
circumstances so that a small number of 
separate WHEN ERRor routines can be 
written to cope with file-related, channel- 
related and general errors as appropriate. 
Some of the error codes appear twice 
because Sinclair Research gave them 
two distinct meanings. The number of 
possible error messages was thus 
reduced to an absolute minimum, but 
error analysis has been made more 
difficult as a result. 

The error code functions return a one if 
they match an error which has occured 
and a zero if they do not. They can 
therefore be used to take action appropri- 
ate to particular circumstances, for inst- 
ance: 


100 WHEN ERRor 

110 IF ERR__NF 

120 PRINT “File not found” 

130 PRINT “Enter new filename” 
140 INPUT file 

150 END IF 

160 END WHEN 


Additionally, two other functions have 
been included which can be used to 
determine the error number and the line 
on which the error occurred: 


100 WHEN ERRor 

110 PRINT “Error = "; ERNUM 
120 PRINT “On Line "; ERLIN 
130 END WHEN 


SuperBasic programmers should be 
familiar with the CONTINUE and RETRY 
commands which are normally typed 
directly from the command line during 
program debugging. With the implemen- 
tation of WHEN ERRor blocks these 
commands can be used within programs 
to control what the interpreter does 
immediately after error processing. 

Both RETRY and CONTINUE are ana- 
logous to the RETURN statement in 
standard user-defined structures and 
subroutines, but whereas CONTINUE 
sends the interpreter to the statement 
following the one which caused the error 
RETRY forces the statement to be inter- 
preted again. Of course, there is little point 
in this if the result is another error, but if 
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the mistake has been corrected by the 
WHEN ERRor block then all should be 
well. 

Super Toolkit 2 users can optionally 
follow both RETRY and CONTINUE with 
a line number at which the interpreter will 
resume. Tony Tebby describes this as 
useful, but there are obvious pitfalls in 
jumping out of a procedure definition 
because of an error and then restarting 
the program at some other, unrelated, 
point. The main value of this feature is that 
an error might occur in the last statement 
on a line and to recover correctly all the 
statements on that line must be repeated. 
The command: 


RETRY ERLIN 

is a straightforward way of repeating all of 
the statements on the line rather than just 
the statement which caused the error. 


Finally, the REPORT command allows 
errors to be reported to a given channel, 
as follows: 


200 WHEN ERRor 
210 REPORT#3 
220 ENDWHEN 


The REPORT keyword can be followed 
by a channel number (the default is the 
command window) and by an error num- 
ber. For example, 


REPORT #2, —12 


prints the text “bad name” in the listings 
window. 

Owners of the Turbo Toolkit have a 
couple of alternative options with the 
DEVICE_STATUS and WHEN__ER- 
ROR functions, the latter only functioning 
in Turbocharged programs. The advan- 
tage of using the Turbo Toolkit extensions 
is that, should your program see commer- 
cial success, it will work with whatever 
version of QL rom your customers own 
because all the necessary code is con- 
tained in the Toolkit runtime module. 

Errors which occur with a WHEN 
ERRor block can sometimes have unex- 
pected consequences, especially if you 
have called a procedure or function from 
within the WHEN clause. It is therefore 
wise to keep “WHEN ERRor’” structures 
short and simple to avoid problems which 
will inevitably be difficult to analyse and 
put right. 

Used correctly, WHEN clauses will not 
only provide better error-tapping for file- 
access routines but they can substantially 
shorthen input routines. Readers with 
very long memories will recall that one of 
the first Better Basic articles was devoted 
to a lengthy routine to error-trap the input 
of numbers. A substantial amount of code 
was devoted to discarding incorrect keyp- 
resses, coping with the complexities of 
unary minus and decimal points, and so 
on. The equivalent routine using a WHEN 
ERRor clause is shorter and easier to 
understand, as the accompanying listing 
demonstrates. 
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-14 ERR_FF 


Format failed - the depressing news 
that a microdrive cannot be formatted. 
Disk format failures are very rare. 
The most common cause of this error is 
simply failing to put a medium in the 
drive. 

CURE: ask for new medium, try again. 


Error in expression — for whatever 
reason, SuperBasic cannot make sense of 
an expression. Multiplying text 
strings together and inputting text 
into a numeric variable are two ways of 
causing this error. 

CURE: ask for input again. 


Overflow —- caused by wandering away 
from the world of real numbers, 
dividing by zero, looking for the 
square root of a negative number, and 
so on. 

PREVENTION: check variable values prior 
to divisions and square roots. tf 
necessary, ask for new variable value 
or replace wrong value with innocuous 
default value. 


4. PREVENTABLE SINCLAIR QL ERROR CODES 


(Preveat these occurrences during progran developaent! 


VAL CODE 
-2 ERR_NJ 


ERR_OR 


MESSAGE and MEANING 


Invalid job - a multi-tasking call has 
been made to a non-existent or 
incorrect task. 


Out of range - caused by: 

— printing outside a screen window (eg 
AT 56,95) 

OR 

- referring to a non-existant array 
element (eg DIM A$(5): PRINT A$(9)) 


Not found - a SuperBasic device cannot 
be found, (eg DIR mdv9_) or a call toa 
non-existant procedure or function has 
been made. 


End of file - can be caused if a READ 
statement is actioned when all of the 
DATA statements have already been read. 


Bad name - a SuperBasic name has been 
used out of context. 


Bad parameter — the wrong number or 
wrong type of parameters have been 
passed to a SuperBasic procedure or 
function, whether part of the language 
or user-defined. 


Not implemented — reveals that you have 
stumbled upon an incomplete part of 
SuperBasic. 


Bad line — caused by any SuperBasic 
syntax error which cannot be more 
exactly described. 


LDEF ror 


SUPERBASIC 


he ability to define named proc- 

edures and functions from 

within SuperBasic means that 

GOSUB need never be used. 
However, this means that the actual line 
numbers, at which routines start, are 
easily forgotten. Also if RENUMber is 
used then it becomes impossible to know 
the starting line numbers of your routines. 
This makes SuperBasic program 
development difficult and cumbersome. 
Should you need to change or examine a 
routine, then you are left with no choice 
but to list the program and search for your 
routine. 

This routine ends all this searching by 
adding the function ‘LDEF’ to SuperBasic 
which returns the start line number of a 
given procedure or function, allowing 
procedures and functions to be listed by 
name, eg LIST LDEF (‘help’) TO will list 
from the start of the procedure or function, 
named help onwards. LIST LDEF (‘help’) 
TO LDEF (‘help’) + 100 will list the first 
100 lines of the same procedure or 
function. , 


A full explanation of the way that Qdos- 


stores procedure and function details is 
given and this will allow assembler prog- 
rammers to examine the built in Super- 
Basic routines in the QLs ROM, so that 
they can be used from assembler routines 
or copied into RAM and modified at will. 

Those of you with assemblers should 
type in the assembler listing and save the 
object code produced under the name 
LDEF__BIN file on mdv1__. Once created 
the extension can be set into use at any 
time by entering the following: a=RESPR 
(200) : LBYTES mdv1_DEF_BIN,a : 
CALL a. 

The QL Name Table stores details of 
almost everthing to do with a SuperBasic 
program and it is constantly updated as 
your programs are entered, amended, 
loaded, and run. Details of the table are 
detailed below. The table starts at 
BV.NTBAS ($18(A6)) and ends at 
BV.NTP ($1C(A6)). Each entry in the 
table consists of eight bytes as follows: 


24 


word one of $0001 
$0101 
$0201 
$0301 


$0501 


Gavin Monk explains how QDos stores functions and 
procedures and produces a routine to list procedures by 
name regardless of the line numbering. 


string variable (undefined) 
string expression 

string variable 

string array 

SuperBasic string function 


$0002 floating point number (undefined) 


$0201 


floating point expression 


$0202 floating point number 

$0302 floating point array 

$0502 SuperBasic floating point function 
$0003 integer (undefined) 

$0103 integer expression 


$0203 integer 


$0303 integer array 

$0503 SuperBasic integer function 
$0300 internal use (substring) 
$0400 SuperBasic procedure 
$0602 REPeat loop name 

$0702 FOR loop counter 

$0800 machine code procedure 
$0900 machine code function 


word pointer to entry in Name List (—1 if expression) 


fong word 


offset into variable area if entry is a variable or negative 


if variable undefined. 
High word is start line number of DEF statement for 
SuperBasic procedures and functions. 


Long word is the absolute address of the routine for 
machine code procedures and functions. 


The Name List contains a list of the 
ASCII for the characters which make up 
the names. Each entry starts with a byte 
which defines the length of the name 
followed by the ASCII for that name. This 
table starts at BV.NLBAS ($20(A6)) and 
ends at BV.NLP ($24(A6)). 

The best way of explaining how to use 
the Name Table and the Name List two 
tables is to work through the given 
example. 

Firstly, all the required constants are 
defined and the function ‘LDEF'’ is linked 
in. Secondly, the passed parameters are 
put onto the maths stack as strings and 
then a check is made to make sure that 


only one parameter (the procedure or 
function name) has been passed. If the 
number of parameters passed is not 
equal to one, the error ‘bad parameter’ is 
given. 

Now the actual guts of the function 
begin. The program looks through the 
Name List until it finds an entry with the 
same length as the string entered. If an 
entry of equal length is found then the 
routine COODBE is jumped to, otherwise 
the search continues until the end of the 
Name Table is reached and then the error 
‘not found’ is given. The COODBE routine 
checks through the Ascii for the name 
and compares it with the Ascii for the 
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SU DEPT a Ure by 1 aE IESE HE SE AE IEE EE FEE DEE JE JE IESE EE HE EEE IE JE FETE IEE TOIT EIEIO HE 
7 REMark * Basic Loader to add the function LDEF to SuperBASIC which * 
3 REMark * returns the line number of the given procedure or funetian 

4 REMark * * 
5B REMark * Copyright (c) G.B.Monk * 
& REM fc 269 26 2 ER EEE EERIE IEF TEIUTEIEGI TE EEE EI EI EH IE HE HE 
18 a=RESPR (22a) 

15 cs=0 

20 RESTORE 10a 

20 FOR i=a TO a+160 

4A@ READ byte:POKE i,ybyte 

435 cs*cstbyte 

S@ NEXT i 

oS IF cst >i2Si1 THEN PRINT ‘error in data’:STOP 
6@ SBYTES mdvi_ldef_bin,a, 200 

7@ CALL a 

10@@ DATA 67,250,8,10,52,120,1,16,78,146 

121 DATA 7B8,117,8,0,8,0,8,1,8,18 

102 DATA 4,76,68,69,70,0,0,0,52,128 

1@3 DATA 1,22,78,146,102,42,12,567,0,1 


14 
105 
1@& 
1a7 
188 
199 
118 
1i1 

Ele 
113 
1144 
115 
Lh 


DATA 
DATA 
DATA 
DATS 
DATA 
DATA 


192, 74,32,110,0,24,52,118,134,2 
213,238,0,22,16,54,160,0,176,54 
152,1,105,14,80,136,177,228,0,28 
99, 230,112,249,78,117,112,241, 78,117 
18,0,83,64,58,725,82,159,82,74 
a2, 129,24,54,162,0,0,4,8,72 

DATA 0,54,0,%2,184,0,194,54,184,0 
DATA 182,208,81,200,255,270,12,54,0,4 
DATA 126,0,103,18,12,54,0,5,136,0 
DATA 182,176,9,1,0,0,183,2,82,137 
DATA Shi, 17%, 61,182,136,4,157,0,120,3 
DATA 113,8,45,72,@,88,78,117,255, 255 
DATA 252,58,2,720,0,0,10,48,0, 1 


a 

i + 

PPPPEEREEEEEEE REE EEEEEEAEEEEREAEEEREE ELLE RESELL EERE PEALE E PSE E EERE EEE EE | < 

id i? if reached here entry is the same length 
y+ Program to add the tunction LBEF ta SuperBASIC which returns the line * 


i# nusber of the given procedure or functsan COODRE 


SF B aeaeaas? 5348 
TD A BOBBRRS4 2449 
ea Sb 5288 
72 1 OBRBRRSE S248 
72 8 GBQBBRSA 5288 
74 2 BOBBBPSC JB3R08E 
75 a GAABBREE BAa4sBE2E 
Th @ BBBBRBLS BBI4BA7ZGRBRR 
77 @ GBBRRRGA BBTKERRE 


NDVE.B 
SUBR.W 
SOVE.L 
ADDA.L 


ne,D1 
11,08 

ANAS 

41,A3 

41,82 

11,83 
G1AG,A2.N) ,4 
4828, D4 
4828, B16 ,AB.L 
Q1AG,A.L3,D4 
NEXT 

18, CREW 


save length 

reduce length by | for loop 
(A3}=leagth on stack 

(Ad2Ist ABCIIT chr# on stack 
next ASCII tor name in list 

next AGCIT for name on maths stack 
DS=AGCIT chrd from name list 
sake it lower case 

make chr$ on stack tower case 

as the ched the saee 

if not same try next name in list 
if same check other chré 


SAE ee ee ET BE REE EE EERE EEE EE EE 
;# Constants, variables, vectors etc. 

[AEE EEE EE PETE RE PEE PE EE ET EE EEE EE EEE EE EEE 
yt 

BPLIN]T = ERU $118 
BVRIP = ER $38 
CA,BTSTR EGU $ilb 
BY, NTBAS ED $18 
BY.MLBAS £21 $28 


wy NTP EDU $10 SAHA eee 


| HUMASOSIEEDOGGTEGAOONCEEROSODELEEDOSOREHEEROGTEEDSOEEEEEDOSEETECED SE FEES 2 ie i Ebachaal Nene aunt Nave: dau fours fate 
' i 33 PAA 
y# Link in function a4 + 


’ 
JAE HHEEE HAE HEHEHE HEHEHE EEE EEE EE 
| 35 B UAGRRT4 ACTORRBIEB RA 


8b @ MAOBATA 6712 

67 @ BOBORE7C ACIOBRESEREE 

BE R @@@0GRB2 1404 

88 f GBOBEBE4 801B002 

SR 8 @@GRRRGE 4782 

$1 @ ORBRRRIA SZB9 

$2 @ QBBR—RRL DICt EVEN 
73 B RBGRGBBE TDBAERA4IBRR FOUND 


beeda 1B 
bepeeesa 
beHdBT 14 
bebHed 18 
bond ae2B 
BRbeedIC 


vector - add SuperBASIC procedures 
SBvariable- aaths stact start 

vector = - get strings 78 @ BRBBAGGE GoDe 
SBvariable~ name table start 79 @ a@RBRR7a SICBFFES 
SBvariable- name Jast start 0 

SByariable- nage table end 3) 


it 


CHPT.B 
HEQ.S 
CHPI.B 
GNE,S 
BIST 
REG.S 
ADDD. L 
ADD.L 
MOVEW 


44,8086, AB.LI 
FOUND 

5, (A6 ,AB, LI 
NFOUND 

48,01 

EVEN 

#1,AL 

11,Al 
$(AB,AB.LI WCAG ALL) return 

SuperBASHC line nuaber on stack 
return word 

no errors 

restare start of stack 

and end 


is it a SuperBASIC procedure 

yes? 

15 [t a SuperBAS(C function 

errar if neither 

check bit zero of length 

even if cera 

restore stack: 1 i# odd Jength 
+length 


LEA 
24 0 GAdRRRBA T47ReL 1a MOVE. W 
25 B R@BBBREE 4E92 og 
25 DB ROMRORBA 4E75 
27 B AORRBREC BbeE 
24-8 bpaed eee 
297-8 BAGORDLA ABEL 
Ma @ BDRRRL? GABA 
B DPAARBLY 4 


definition table 
link it in 


DEFTABIPC) AL 
BP. INIT ,A2 
[Azt 

and return 

nuaber of procedures 

end of procedures 

nuaber of tuncticns 
relative pointer to rautine 
length ot ¢unction saae 

@ ppRAGBTS 4CH4AS40 “UUEF function nate 4 WR aeeees4 7583 
i) 


A . 8 end of functions 95 B GORORRIS 78BB 
een : " 96 B MAGBREG 2D49RR5E 


ST @ BOBBRRIC 4675 


OEF-+ 


NOVEO 
NOVER 
MOVE. L 
ATS 


13,04 
98,08 
A1,BY. RIP IAB 


uy 
7] 
vy 
+t 
n 
uM i 
5 [REECE EEO REP ED AE SE RE EEA De PP CUED RAD PEE CED PEER CRD E EPL CER EREET ‘ 
At) ;# Get parameters onta the maths stack 6 \* 
r 
L: 


HCREPESSEL ERD PEATE ESO OEE ACER PD DECEEOPEEEE ERP EP ETECCEFEEEECE ERE EEEEE OP EREE " tnd 
13 , feeu TOTAL ERRORS = @ line 


u : este TOTAL WARNINGS = @ (line » BI 


48 B MOQBBBIC TATHG18 = LDEF HIVE.W CA, GTSTR,AZ mencry usage = Ebytes 
$2 0 NOMOOB2E 4E97 ISR Wii 
42: QQaBRE?? 6424 BME.S =| S227 

43 8 MOMBBD28 ACAI CHP.M 1,03 
44 B AQQDBEIS 44772 BME.S © 4RMERR 
45 nu 


' 
t 
i 


get string parameter orto stack 
Al naw equals “ew stavt of stack 
exit wf error 

L parameter "equired 

error if nat } 


BP. INIT 
BY. MLBAS 
BY.NTBAS 


BBbeR | 1a 
opbeneza 
appeee1a 


as 
My 
8 


pee PE DPPH TERE REEL CL ED RESET E REDE EEHE OPES ES ER EEF ESERS FEPEESECRTEPEEEE TOR EEE 
jh search the vame tate and list for the required nave 
PECCUHAECOE HH AECOEE CCCP PE EGC PR BACCO PP PEER ES PER OA EER DEERE ECE E 


ARBRREIC 
aaReResE 
QBBRE 11h 


BYHTP 
BY. RIP 
Ch, BTSTR 


aq ru 
‘50 8 HOBRGO2A 2PLERRIS 
St B WWOBRB2E SATSBANT 
£2 8 AQBBRET2 CSEEREZD 


STB RRGRGASS 1ATbARNO 


CHRCHK 
CODDBE 
DEFTAB 
EVEN 
EXIT 


8 bA8e8O5B 
b neeneRse 
® peaaaeee 
B pROdABEC 
8 BRRGGRME 
® PRO@BREE 
4 BRBRREIC 
8 BepEREZE 
@ bepeeEse 
8 epbOHESS 
0 BRBRREAC 


start of nage tatle 
offset cnta rage List 
add start c+ name [rst 
BBelength froe name Jist 
54 0 RRRR@AIA BHA FERL CHP.B TtAG ALLL) 08 is it the same length as string entered FUNG 
55 Q Q@OVORPIE 6718 BEQ.S CODDBE if sa it could be the one LOEE 
fa LOP 
‘5? B ad@e0048 SBEE ADDE.L 49, AB next entry in name table NEET 
‘38 BR RORRGAS? BLEEBRIT CHPA.L | BV.MTP(A) AB check tar end of name table NF OUND 
59 B AOQBDEAS 4364 BLS.S LOOP repeat if not the end PARMERR 
4a 

41 NOVEG 
42 DB GOGRRRAS 4E75 ATS 
43 0 QQBRBAC TOFL NOVEG 
64 @ MMORORAE 4E75 ATS 


MOVE.L 
MDVE.U 
ADDS.L 


WOVE, B 


WYANTERS LAA! (Al 
THAS AB. LI 82 
BY.NLBGE La! 82 
@1Ab,A2.M) 0B 


\JOF 


47,08 ‘not found error’ 
return the errar 

“had parameter error’ 
return the errar 


15,04 


all Ascii characters match) then the type 
of the name is checked to see if it is a 
SuperBasic procedure or function. If it is 
neither of these then the error ‘not found’ 
is given. If the name is found then the 


passed parameter, after making both 
lower case. If the Ascii is not the same 
then control jumps back to the search 
through the Name List. 

If the required name has been found (ie 


stack is adjusted for odd or even length 
paramter names and the start line number 
of the procedure or function is put onto the 
stack. This is then returned as a word to 
SuperBasic. 
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INFORMATION: 
Program: Media Manager Special 
Edition Price: £49.95 

Supplier: Digital Precision Ltd., 222 
The Avenue, Chingford, London 

E4 9SE. Tel: 01-527 5493. 


here was an earlier version of 

Media Manager, about which 

the less said the better. It 

performed certain functions 
adequately, and gave many of its users a 
hard time. When you have lost a file and 
the recovery program gets it back for you, 
you are likely to feel magnanimous. But 
there was an obvious need for an upgrade 
to this particular program. “Upgrade” 
tends to imply a minor rewrite of parts of a 
program, and the addition of a few 
features, but that proved to be unwork- 
able here. It was a case of “back to the 
drawing board”, with a fresh sheet of 
paper and a revised specification. It would 
not be possible to cover the program 
features adequately in one issue of the 
magazine, so this first part deals mainly 
with the general layout of the program, 
and the recevery of corrupted files; the 
second part will deal with the file-transfer 
utility operations. 

Mediu Manager Special Edition is the 
result of collaboration between two of the 
QL world’s most notable personalities 
author Chas Dillon and supplier Freddy 
Vachha. Neither can be easily catego- 
rised. To anyone acquainted with them 
both, the immediate thought would be 
that the program was not developed in the 
quiet of a library reference room. There 
was much discussion, not all of a peaceful 
nature, and the result is a product which 
has a strong air of having been well 
thought-out. The interface with the user 
alone is something one could spend time 
playing with, and the operational modules 
behind the outer face are a well-integrated 
collection, 

If you are familiar with the IBM PC, 
you are likely to come across a suite of 
programs called Norton Utilities, which 
were generated by another colourful per- 
sonality, Peter Norton — who is noted for 
parking his photograph prominently on 


26 


of a corrupted file or volume (which is the 


= 


Figure one: The main menu. 
Bryan Davies 
finds that the new 
Media Manager 
does things that 
the old one 
couldn’t manage. 


his product packages. Media Manager 
aims to perform a similar set of functions 
for the QL. The requirements are the 
same in many respects, but there are 
significant differences in the way drives 
are handled on the QL which make the 
work more difficult. By repute, the 
ODOS operating system owes a lot to MS- 
DOS, although this might not be obvious. 
There is an impression that the firmware 
driver for the microdrives was written 
when MS-DOS was around, but the disc 
driver was an attempt to get away from 
this influence. Whatever the reasoning 
behind the drivers, they differ sufficiently 
to be considered as very different proposi- 
tions when writing file-recovery routines. 

The initial need for a program like 
Media Manager is likely to be the recovery 


edi tonager Spaciak Edition, wid ~ Un ter 


general term for a whole cartridge or 
disc). The program is also usable in a 
“healthy” situation, though. In particular, 
the MS-DOS-to-QL (and vice-versa) util- 
ity XOver is included and is accessed as 
one of the Media Manager menu choices. 
As is typical of Digital Precision’s pro- 
ducts, the software is accompanied by a 
comprehensive instruction manual; this 
gives thorough coverage of the various 
functions, and the usual helpful explana- 
tions on the structure of the QDOS disc 
and cartridge formats. Breathe a sigh of 
relief, for the manual is “only” 37 pages 
long, which is appreciably smaller than the 
less clear manual supplied with the origi- 
nal Media Manager. 


Figure two: Primary device selector, 
select working device. 
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The space taken by the program has 
also been reduced, a minimum of 384KB 
being required to run it. It is available on 
cartridge or disc (both sizes), and is usable 
on all Thor models as well as QLs, as is 
typical for DP programs, SuperBasic 
extensions are loaded first to provide 
MMSE with necessary additional com- 
mands. Users who already have the Xtras 
file loaded as a matter of course do not 
need to change, so long as the version of 
this file being used is 3.10 or later. MMSE 
will multi-task with other programs. DP 
emphasise the disc uses for the program, 
because it is generally harder to recover 
information from discs than from car- 
tridges. Whatever the storage medium, it 
is a golden rule not to attempt recovery on 
the corrupted volume itself, as this is a 
sure way of increasing the size of the 
problem. The first act should always be to 
copy the information from the bad volume 
onto a good one, so that the recovery work 
can be done on the latter. As you might 
expect, the wisdom of doing this was 
proven during the course of the review, 
when the working copy disc of MMSE 
became corrupted. 

You can’tgo through life as a computer 
user without occasionally meeting “bad or 
changed medium”, “not found”, or “read/ 
write failed”. With luck, re-inserting car- 
tridge or disc in drive will cause the 
message to go away. If not, you have to 
consider whether a) the problem is mecha- 
nical in nature and affecting all columes, 
and b) it is specific to the particular 
volume and likely to be caused by data on 
it being corrupted. With microdrives, 
mechanical derangement should be top of 
the list of possibilities. You can be vir- 
tually certain that the rubber rollers on the 
drive shafts will wear, get covered in tape 
debris, and ride up the shafts, given 
sufficient use and time. The read/write 
heads also collect dirt and become worn, 
but they are unlikely to trouble most 
users. If you don’t service the drives 
periodically, you can expect the messages. 
Disc drives are much less prone to 
becoming unserviceable, but failure to use 
a head cleaner at regular intervals is a sure 
way of inviting trouble in the long run, 

A careful user can avoid mechanical 
problems, and can also steer clear of 
database troubles, by making sure to close 
files before moving on to another job or 
switching off. To a large extent, one can 
also avoid problems which are initiated 
electrically; effective suppression of the 
mains supply will considerably reduce the 
likelihood of lockups. There remains the 
corruption problems which are largely 
outside the control of the user, such as 
crashes caused by software bugs or sudden 
loss of the public electricity supply. 

Individual files on a volume are of little 
use in themselves, because access to them 
is via a reference area which is present on 
all formatted volumes, and problems with 
this area can render some or all files 
unavailable for use. The terms “map” and 
“directory” will be met in connection with 
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Figure three: Device utilities, show 


QL cartridges and discs. Briefly, the map 
contains a record of what is where on the 
volume, and the directory lists the files 
contained on the volume. You don’t have 
to erase a file from a volume to get rid of it; 
all that is necessary is to delete the 
reference to it in the directory. 

What is erased differs between car- 
tridge and disc; it is more difficult to find 
deleted files on disc than on cartridge. As 
far as application programs are con- 
cerned, any file which does not appear in 
the directory does not exist. 


Deleting 


The act of erasing (deleting) a file leaves 
the actual file intact, but it passes the 
message to the operating system that the 
space taken by the file is now available for 
use by other files. This means that, until 
other data is written onto the area occu- 
pied by the deleted file, there is a good 
possibility that the file can be retrieved. 
All that is required is to rebuild the 
directory entry for the file, in the correct 
position in the directory, and to identify its 
physical location on the map. Once one 
file has been overwritten by another, 
recovery becomes either difficult or 
impossible. For this reason, the best thing 
to do, as soon as trouble is detected, is to 
stop using the suspect volume, before 
anything else can be written to it. 

The list of functions on the first page of 
the instruction manual seems a good place 
to start looking at the program. What is 
offered is the ability to obtain intelligent 
directory listings; perform selective file 
operations; restore deleted or corrupt 
files; sort directories by name, date or 
size, in ascending or descending order; 
read from and write to, alien discs (in MS- 
DOS/TOS formats); perform direct sector 
reading, editing, and writing operations 


unfiltered directory. 


on microdrives, or any disc (alien or QL 
format), and obtain full diagnostic print- 
outs of media storage maps, for enhanced 
security. 

Two features which become more 
appreciated as the program gets more use 
are the context-sensitive help lines and the 
selection of items on the menu by pressing 
single keys. The help is not verbose — it is 
one line at the bottom of the screen — but 
it is well thought-out, and makes the point 
without getting in the way and without 
having to be called-up separately. The 
single-key menu selection does not apply 
to the main menu, but comes into force 
once the user has got down to the 
operations of examining or working upon 
files and volumes. The manual points out 
that a rhythm of keypresses can be 
developed for long recovery jobs, with the 
presses becoming more or less a reflex 
action, with no real need to look at the 
menus. 

A file of parameter defaults can be 
loaded automatically when the program 
loads. You can change the defaults from 
the main menu, once the program is 
running, but free-standing routines are 
provided to enable the default file to be 
customised to the user’s satisfaction. Data 
can be printed to a printer, or toa file. The 
output device for reconstructed files can 
be mdv, flp or win (not a printer). A 
SuperBasic prograrh is provided for the 
purpose of writing a set of sample files to 
disc or cartridge to experiment with. 

The source code of the microdrive 
access routines is supplied, for those users 
who are in really deep. The companion to 
this file is one of extensions, which is 
created by passing the first file through the 
HiSoft assembler. Initial releases of 
MMSE will have a line-numbered version 
of the program file, a somewhat unusual 
step to cater for the possibility (remote, 
according to DP) that the normal program 
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Figure four: Device utilities, recover 
lost/corrupt file. 


file crashes; should it do so, you are asked 
to run the line-numbered version and try 
to repeat the performance, noting the line 
at which the crash occurs, 

A backup routine and the usual Quill 
file of updates (with nothing to say at this 
time) completes the set. The backup 
routine needs to be used, because it puts a 
zero-length-name file onto the working 
volume, and this file is looked for by the 
MMSE program. This does not prevent a 
working copy being made using the Copy 
or WCopy commands, but instructions are 
given for creating the zcro-length-namc 
file, since the copy commands won't do 
this. Provision has been made for the 
addition of other function modules, with- 
out MMSE itself having to be changed. 
Once MMSE is running with the main 
menu displayed, the program disc can be 
removed; it will only be needed again if 
the File Copier option (or other options 
released in future) are required. 

From the start, availability of functions 
is indicated by colour — when text is 
white, the option is available, but items 
with green text are not available at the 
current point in the procedure. Options 
arc contained within two columns, cach of 
six blocks, and the “cursor” is a green 
border to fit around the blocks (Figure 1). 
There is no need to use the up/down 
cursor keys to move the cursor, since the 
left/right keys step the cursor from side to 
side between the columns, highlighting all 
options in sequence, Although no num- 
bering is displayed on the options, the 
cursor can also be moved to any of the 
upper ten options by pressing the approp- 
riate numeric key, 0-9. Selection is by 
means of the space bar or ENTER. A line 
at the bottom of the screen gives brief 
information on the option currently out- 
lined by the cursor. A welcome feature, 
keeping operaton in-line with current 
fashion on various computers, is that the 
ESC key can usually be used to step back 
to the previous menu, escaping from the 
current one; this is not possible once 
certain operations have been initiated. 
Where you are requested to answer a 
question with (Y/N), pressing the ENTER 
key is equivalent to pressing the first 
choice key, which gives consistency with 
programs such as The Editor. Another 
consistent feature is the use of F4 to 
refresh the screen. 

The cursor is automatically placed over 
the option which is deemed to be the one 
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most likely to be needed, so you don’t 
have to waste time driving the cursor 
around every time you sclect an option. 
Care has to be taken to provide a normal 
QL cursor on each screen, making the use 
of CTRL+C to switch to SuperBasic or 
other programs possible at all times unless 
some critical operation like formatting a 
cartridge is in progress. The initial options 
available are limited to selecting primary 
devices, setting the QL date, using the file 
copier routine, and returning to Super- 
Basic. The file copicr will be dealt with in 
part two of this review. You cannot get on 
with the job in hand until the primary 
devices have been selected — working, 
output and print. 

You are posed a question, after selec- 
tion of the working device, and it deserves 
some thought. Do you wish to write to the 
selected device, or not? As noted before, 
it is recommended that a faulty volume is 
not disturbed in any way. The volume may 
not be faulty, or have only minor errors on 
it, and you intend to make some changes 
to it, in which case you would opt to be 
able to write to it. Cartridge and disc are 
treated differently; the dodgy nature of 
cartridges dictates that a copy be made of 
the “target” one (in the working drive 


straight away, and this is done to ram, 
with bricf details of the cartridge being 
displayed on-screen, You are warned that 
this process — which nominally takes a 
few seconds — can be lengthy, if the 
cartridge is in bad shape. With a disc, a 
complete ram image is not necessary, 
and you are first presented with an 
analysis of the basic parameters — tracks, 
sides and sectors. You are free to change 
tracks or sides at this point. More compre- 
hensive information is then supplied, such 
as the total number of sectors and the 
number of them which are good, the 
update count (how many changes have 
been made to the disc since the last 
format), and sector tables. At this stage. a 
message containing the words NOT 
HEALTHY is forewarning of work to 


Figure five: Sector editor, hexadecimal display — “layout” highlighted. 


come (Figure 2). Note the MMSE is 
looking for corruption in map and direc- 
tory areas; if you cared to copy perfectly 
good map and directory information from 
one volume to another, there would be no 
reason for the program to say something is 
wrong. 

Endless description of menus will not 
make the uses of any program too clear to 
readers, so what follows is an account of 
the recovery of material on a particular 
volume. A disc is used for the example, 
but the procedure is basically the same for 
a cartridge. The particular disc had been 
corrupted to the point where a normal 
directory request produced the sector 
count, and nothing else, apart from the 
drive indicator being continuously alight. 
The disc had been formatted in the formal 
fashion, then loaded with files using the 
file-generation routine supplied with 
MMSE. 

The disc map had then been replaced by 
another one, that did not pertain to the 
files on the disc; various files had been 
deleted, and others copicd onto the disc. 
Somcthing was obviously wrong, since no 
tiles were shown as existing when the DIR 
command was issued. When the primary 
device selection was made, the Disk 


Volume information displayed was plausi- 
ble, and there was no NOT HEALTHY 
message, The next step was to return to 
the main menu and sclect Directory 
Management, followed by Show Direc- 
tory. This is where a problem became 
obvious; three files were shown as being 
on the disc, but they were beyond the 
“Logical End of Directory”. That is, there 
was nothing at all in the directory, 
meaning no files on the disc, yet three files 
were said to be on it. Notonly that, but the 
files were numbered 17-18-19, indicating 
that there were, or had been, other files 
there. 

The directory that had been obtained 
was of the “filtered” type. which is like the 
SB DIR command and does not show 
deleted files and blank entries. A more 
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relevant listing was obtained via the 
Utilities and Show Unfiltered Directory 
options (the example in Figure 3 is not for 
the disc referred to here). This showed 15 
files before the Logical End of Directory, 
number 16 immediately after the end, the 
three already found (17-19). and four 
more (20-23). 16 and 20-23 had “no name~ 
as the file names; this indicates the length 
of the file name is illegal. The files actually 
within the directory area had file lengths 
which were impossibly long, and names 
which obviously had not been given to 
them by me (most of them were the same, 
anyway). 

By now, it was clear that there were 
quite a few files. and that the directory was 
a complete mess. As a precaution, the 
Sector Copier option was chosen from the 
main menu; this automatically makes a 
bit-for-bit copy of the original volume 
onto another one, so that recovery work 
can be done on the copy. Since the copy is 
exact, down to the volume name and 
format details (this disc had been format- 
ted to 36/612 sectors), it can be substituted 
for the original in the working drive, 
without MMSE getting upset. 

Several recovery procedures are 
offered, to cope with the severity of the 
problem, Using the Recover Lost/Corrupt 
File option (Figure 4) from the Utilities 
menu is first choice, but may not be 
effective, if the information you have on 
the lost files is insufficient. For instance, 
you need to know the File Number; to 
avoid possible unwanted material in a 
recovered file, it is desirable to know the 
length of the file to be recovered. If you do 
have the information, you just tell the 
program to “go to it”, and wait for your 
file to be churned out. Otherwise, you 
need to go to the next, less-automated 
level of options. 

We have now worked our way to the 
“low level” Sector Editor function, having 
found that the relatively automated oper- 
ation of the functions prior to this may not 
be fully effective when the map and 
directory areas are bad in some way, and 
knowledge of the lost files is insufficient. 
There are a considerable number of 
options on the menu now (Figure 5), and 
they can be chosen by the cursor keys, or 
by pressing the first letter of the option — 
if several options start with the same 
letter, you keep pressing the letter until 
alphabetic progression gets you to the one 
you want. This is where convenience of 
selection is needed, because most time is 
going to be spent here when a volume is 
badly corrupted. The manual advises the 
user to develop a rhythm of keypresses, 
particularly once the collection of file 
sectors has been started. 

For most users, recovery will be easier 
for a text file than for a program one, 
because they will be able to recognise 
some of the file contents, Choosing Utili- 
tics and Show Alloction Summary allows 
you to see what each Allocation Block 
contains. This will. for instance, let you 
know which blocks contain the beginnings 
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Figure six: Sector editor, commit 


message: This is a POWER command. 


of files, so that you know where to start 
when piccing files back together again. If 
you know a file name, or some text at the 
start of the file, you can use the Sector 
Editor Locate or Search functions to find 
files. Locate looks only in the file header, 
so it is the function to use when looking for 
a file name, whereas Search looks all 
through, and is therefore more compre- 
hensive, but slower. 

The files created for you by the example 
routine have nice simple names, starting 
with “FILE:A™. Repositioning to the start 
of the disc (Track O/side O/sector 0) and 
using Locate soon found the start of 
FILE:A, even though the directory sho- 
wed the name as something quite diffe- 
rent. Consider the possibility that more 
than one file has ended up with the same 
name; this can be checked by using Locate 
again, from the point where the first file- 
start has been found. At this point, the 
thing to do is Open Collector — open a file 
(in ram for greatest speed of use) in 
which to collect the pieces of FILE:A. Not 
surprisingly, DP recommend that you use 
The Editor for “massaging” recovered 
files; having used the program fora couple 
of years, | would not argue with the 
Suggestion, as it seems the most suitable 
tool for the job. Bearing in mind that 
MMSE and The Editor can be multi- 
tasked, progress with recovery can be 
monitored by switching to The Editor and 
loading recovered files, to see that they 
look as they should; gaps can be filled, 
corrections made, and unwanted material 
(likely at file ends) can be deleted. 

Collection can be done piece-by-piece, 
using Collect, or in larger chunks, using 
Bulkwrt (bulk write). The latter automati- 
cally uses the Locate function to find the 
start of a file, provided you have the name 
to give it, and the name has not been 
corrupted on the disc. You are asked for 
the number of sectors to be collected, so 
that it can calculate how many collection 
operations to do. You may have no idea of 
the file size, but it is worth trying to 
recover a file with Bulkwrt, to see whether 
or not it looks like being effective. When a 
file is obviously in such a mess that only 
visual linking of its contents makes sense, 
you use the Collect option instead. 

The start of the file is found by the 
Locate function, if possible, if not, the 
first known piece of text can be found by 
Search. When the latter approach has to 
be taken, the Logical move options can be 
used to move backwards and forwards 
within the logical file structure (as oppo- 


sed to moving physically step-by-step 
through the disc, which is unlikely to 
relate to where many of the pieces of a file 
are recorded). In the example disc being 
recovered, the file names still existed; 
once the first one had been Locate-d, a file 
was opened by the Opneoll (open collec- 
tor) option, and the first Collect operation 
initiated. The Allocation Blocks are 
divided into a-b-c sections, and you are 
assured that data will always be found in 
abc order, except in circumstances (which 
usually won't occur) where disc sectors 
have been corrupted one at a time. 

Completion of the first Collect opera- 
tion leaves you with a screen displaying 
the next Logical point in the file, as the 
program sces it. If it looks the right place 
to vou also, you simply press the ENTER 
key three times and this piece is collected 
automatically too, and so on until you 
reach a display of data which is obviously 
at or beyond the end of the file. The 
collector file is then closed with the Clscoll 
option, It's worth having a look at the file 
in The Editor, or by Copy-ing it to the 
screen, to satisfy yourself that it is basi- 
cally correct and complete. 

All the remaining filcs from the exam- 
ple disc were recreated this way. Some of 
them required attention in The Editor, 
mainly to remove unwanted portions from 
the cnds. Once having got into the swing 
of it, the procedure was straightforward 
and reasonably speedy. When the volume 
has been badly messed about, recovery of 
any sizeable amount of information is not 
going to be a five-minute job, but the time 
taken on the sample seemed in proportion 
to the size of the task. The disc used for the 
copy of the original, bad disc was not 
formatted beforchand, and had a number 
of other files on it. 

Nothing had been done to remove these 
files, so they appeared on-screen when the 
Show Allocation Summary option was 
used. The sample disc had been formatted 
to 594 sectors, against the 1440 of the copy 
disc, and “other” files were clearly in the 
area above the 594 sectors; in this inst- 
ance, these extra files were ignored, and 
they didn’t upset recovery of the sample 
files, but it would have been possible to 
recoyer those portions of these extra files 
that had not been overwritten when the 
copy was made. For the brave, there is the 
facility to correct Directory entries, as 
illustrated by the message in Figure 6, 
“This operation is a POWER command 
and it bites!”, so should be treated with 
caution. , 

A further test was made with two 
existing document files, one from The 
Editor and one from text”. Parts of the 
files were overwritten, and the directory 
entrics for them were corrupted. Three 
different approaches to recovery were 
taken, and they produced near-identical 
results. The recovered files were loaded 
into the programs they were written in and 
they looked just as they ought to. 

The remainder of the program is dealt 
with in Part 2 of this review. 
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L owners have had 

access to Archive 

for as long as they 

have had QLs. All 
must have tried a few things 
with GAZET.DBF, and many 
will have developed applica- 
tions of their own. However, 
my impression is that Archive 
is rarely thought of as a real 
computer language. Its full 
possibilities are not even 
exploited in database applica- 
tions — its ‘natural home’. In 
other computing areas it tends 
to be ignored completely, even 
though it has much to offer. 
This short series is intended to 
demonstrate some of the prog- 
ramming possibilities of Arc- 
hive, utilising its strengths, and 
providing solutions to some of 
its weaknesses. 

What are the strengths of 
Archive? Why use it instead of 
SuperBASIC or C? The prim- 
ary justification must be speed 
— not speed of execution, 
certainly; it is well down those 
particular stakes, but more 
important in many instances is 
speed of development. The 
reason Archive may be well up 
here is because itisa4GL—a 
Fourth Generation Language. 
In other words, an extra layer 
of the programmer's job has 
been done already. Time con- 
suming problems have already 
been solved, and the solutions 
made available in an easy-to- 
use form. 

Psion saw the storing of 
information on disk and its 
subsequent manipulation as a 
prime problem, and set out to 
solve it. The ability to search, 
order and select records, use 
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Robin Stevenson 
starts a four-part 
series in which 
he explores the 
strengths and 
weaknesses of 
Archive. 


ARCHIVE AND OPL 


evelopment ‘of the 

Archive language, 

along. with the. rest 

of the Psion°prog- 
rats, morevor less halted over 
three years..ago. At that point 
the company’s energies began 
to be taken up instead by the 
Psion Organiser, in its various 
configurations. A: vitalepart of 
the Organiser. —- built.into its 
operating system in»the way 
that SuperBasic is.in the QL.— 
is OPL, the Organiser Prog- 
ramming, Language. However 
the Psion» software. team did 
not »start .from. scratch. with 
OPL,; ratherthey started from 
the’. Archive language. The 
result, while not, identical to 
Archive,.is very much a dialect 
of the same language. 

With: the launch. of. Psion’s 
Mobile. Computers OPL has 
been given. yet another plat- 
form, built into the operating 
systems. of ‘the MC200. and 
MC400s, ®. with their ..exciting 
multi-tasking, windowing; 
graphics user interface. If 
these. machines take off in. the 
way Psion. hopes, OPL ‘looks 
set to expand ‘in significance 
over the next few years. 

So in .what .ways. is, OPL 
similar, to. Archive?’ Like ‘Arc- 
hive “it is based entirely on 
procedures. Layout is . the 
same, ends. of. ‘statements 
being denoted: by colons. or 
ends-of-lines. - Mathematical 


operators’ are “identical, The 
keyword listis broadly’similar, 
especially input and output, as 
is the. approach to data files. 

The «differences. are. “not 
slight, but. are mostly »differ- 
ences of detail. A number of 
keywords have been shorte- 
ned, and.there.are a number of 
new .ones, ‘both «procedures 
and functions, working at low 
level (eg peek and poke com- 
mands,” free» device .. Space; 
etc.) and»at, high. fevel (eg 
trigonometry/log functions.and 
built. in “menu function)... An 
integer variable type is avail- 
able. . Variable « assignments 
don't need a LET keyword. 
Funetions:. returning’ a’ string 
end.in.a dollar sign: 

Other «differences. will have 
more. effect on programming 
style. Procedures are all stored 
individually “on. the . storage 
device; so each can be easily 
shared between many applica- 
tions: They’can return a value, 
as: in. SuperBasic FuNctions. 
Procedures are’stored in ascii 
form, but-also as ‘translated’, 
executable files. All variables 
must -be.. declared’ as either 
LOCAL or GLOBAL: The Jatter 
ate available to procedures 
called by the.‘parent', butdike 
LOCAL. variables; cease to 
exist when the parent proce- 
dure is completed, 

There are. a numberof useful 
additions to the:control struc- 


tures.» A new . structure, 
DO:UNTIL<exp>. ‘is © avail 
able, similar ‘to *\WHILE<ex- 
p>..ENDWH, buttesting for an 
exit after the body of the loop. 
Both loops. can be exited using 
the BREAK command. 
IF. ELSE ENDIF.“ is’, “also 
enhanced .by. ‘addition of 
ELSEIFs, allowing: easy:.test- 
ing of alistofoptions. You can 
also. GOTO a labelled line: 

The main ommission‘on:the 
Organiser is the. lack .of. the 
more powerful file commands. 
There-are no indexing, select- 
ingy. or.locating..options, which 
mustilimit its usefulness as a 
database language. Less.sur- 
prising,..given. the organiser's 
screen, is the abserice*of the 
screen editing and input com~ 
mands. However there are 
USR functions, as in Archdev, 
allowing links:to other machine 
code programs. 

The MC Mobile Computers 
contains :an-enhanced version 
of .OPL,. which ..presumably 
allows ‘access to their special 
features «—* the *touch-pad 
pointing device, resizable win- 
dows, multi-tasking, and ail the 
other wonderful. things Psion 
are crarmming-into ‘their new 
boxes. If you-are planning a 
mobile’ addition to° your:hard- 
ware, in the*shape of one: of 
Psion's offerings, familiarity 
with Archive.will make learning 
OPL a doddle. 
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disks‘microdrives as virtual memory, 
input and modify data, and use several 
files at once give it the database leaning, 
although plenty of other applications can 
make use of those features. 

Other aspects that make for easy, quick 
program development include the prog- 
ramming environment, error trapping, 
screen ‘painting’, and the printer driver. 
Programmers will have their own priorities 
over these and other features, and all will 
have a matching list of limitations and 
grumbles. Nevertheless, they represent 
facilities that take huge programming 
effort in a more ‘conventional’ language. 
By getting rough prototypes up and 
running in a few hours, and decent 
working versions soon after, applications 
become possible which would be comple- 
tely unjustifiable otherwise. 

Obviously this series cannot deal with 
your specific problem, so instead | will be 
developing a selection of more general 
‘Desktop functions’: a notepad cum card- 
index file; a calculator; a calendar and a 
to-do list cum appointments diary. These 
will all be integrated into one Archive 
application, but of equal benefit will be the 
toolkit we develop on the way. This will be 
a range of re-usable procedures for menu 
and prompt handling; file, window and 
printer control and coping with dates. 

The program we develop will be pre- 
sented each month as listings. Familiarity 
with Archive EDIT is essential. Suffice it to 
say here that each procedure needs to be 
created via the <F3> command. There 
are added complications to printing an 
Archive program: one is the use of 
‘screens’ created via the SEDIT com- 
mand. As well as improving screen 
appearance, these provide much better 
input options than are possible purely 
through program code. They will be an 
integral part of our program, and will be 
printed in the form of anotated screen 
shots. 

Another complication derives from the 
problem of QL memory. Owners of beefed 
up, fat cat QLs may have forgotten about 
this, but an unexpanded QL only has 
some 20K available after Archive has 
swallowed up the chunk it uses. Our 
program will be usable on an unexpanded 
QL, but only just, and only through various 
devious means. One of the techniques 
used is to ‘chain’ the programs. Unlike 
SuperBASIC, an Archive program can run 
another Archive program — without los- 
ing the existing memory or file variables. 
We shall end up with three linked program 
files. One is a short initialisation program. 
Secondly, the NOTEPAD program will 
also provide the main menu. Finally the 
CALENDAR and TO-DO LIST programs 
are combined. The CALCULATOR is to 
be available from any standard menu, so 
it is present in both main programs. 

For unexpanded QLs memory man- 
agement becomes significant, especially 
as Archive doesn’t manage very well. 
There is a gentle decline in available 
memory as programs are run, ultimately 
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causing ‘out of memory’ errors. There are 
ways of optimising memory, however. A 
couple of kilobytes can be gained by 
clearing out SuperBASIC, in the bootpro- 
gram. If you replace the EXEC_W 
MDV1—_ARCHIVE. Alternatively (or in 
addition) you can sacrifice some of the 
less-used functions in the program. This 
will not apply to anything in this month's 
listings, but you may decide, for example, 
that you can live without the CALCULA- 
TOR option, developed in part three, or 
some of the more obscure features added 
to the NOTEPAD next month. One advan- 
tage of typing in and understanding a 
program in this way is that you can reach 
you own compromises, rather than being 
stuck with mine. 

Before we go into the details of the 
program we shall discuss a number of 
design decisions which have been 
incorporated into the toolkit procedures. 

Consistency in screen layout is impor- 
tant. Learning to use a program is in large 
part learning where on the screen to look 
to find out what is going on, and what can 
be done. Under the system provided here, 
all available actions are shown in the 
prompt area. Following Psion's lead, we 
shall use the top few lines of the screen. 
However, in addition to menu choices, we 
will also use the prompt area for text 
responses. There are distinct benefits in 
keeping all tookit actions within a well 
defined area of the screen in this way. 
Application screens can then be designed 
with that in mind, and there is no danger of 
toolkit procedures trying to write over 
data, or vice versa. We shall also use the 
bottom line for general system informa- 
tion — in this case available memory, date 
and time. 


To summarise, of the 25 lines available 
on screen, Line 0 is to be used as a 
heading. Lines 1 and 2 are the normal 
prompt area. Line 3 is a delimiting line. 
Lines 4 to 23 are available for application 
data. And line 24 is for system informa- 
tion. Our program assumes screen 
MODE 0,8. The main problem with 80 
columns of tv is the top and sides drifting 
out of sight. To counteract this, minimum 
use has been made of these areas. 

The other convention adopted relates 
to writing safe, re-usable toolkit proce- 
dures that will not affect, or be affected by, 
other procedures used alongside them in 
an unexpected way. As Archive proce- 
dures cannot return a value (as in Super- 
BASIC FuNctions) the only way informa- 
tion can be passed back is by global 
variables. To keep an orderly, predictable 
pattern to this we shall restrict ourselves 
to anumeric and a string variable, respec- 
tively called ANSWER and ANSWER$, 
and the numeric variable YES for when a 
true or false value is required. 

To minimise the ‘side effects’ each 
procedure must exist as much in isolation 
as possible. There are three primary rules 
for achieving this ideal. 1) All information 
the procedure needs is passed as a 
parameter 2) All intermediate variables 
should be local 3) Communication back to 
the calling procedure should take place 
only by one or more of the above global 
variables. This is not just purist mumbo- 
jumbo. It is part of making maintainable 
code. In this way the entire effect of any 
changes to a procedure are visible in the 
procedure itself. 

This month's listing is the first half of the 
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F5>' Cale 
0 Exit 


NOTEPAD/CARD INDEX 


Title line : NOTEPAD — MAIN MENU 
The main menu of the NOTEPAD/CARD INDEX program offers five options. 


Two of these operate directly:- 


current page. 


notepad file. 


printer: 
BYTES.: 2382 


ARCHIVE DESKTOP 
PRESS OPTION NUMBER OR INITIAL 
1. Find another page» 2. Actions .3. Text 4. Print 


TEXT puts you‘in text editing mode, allowing alterations tothe text of the 


DELETE requires additional confirmation, which if given will.delete the 
current page. Note — this is a non-reversible action. 


The remaining three options offer’a number of sub-menus, as follows:- 
FIND ANOTHER PAGE = back a page; next page: go to given page number; 
search forgiven word; enter new»page; contents. 


ACTIONS.— miscellaneous options to cut»and insert lines on the current 
page: sort, sélect,-or reset the pages; or-use a different 


PRINT = presents a range of’printing options requesting start and end 
pages, options to include page numbering, title, and blank-lines, 
and to send an extraline or formfeed between. pages. There is 
then a chance to send output to screen or file, instead:of the 


Fig. 1: The main menu screen of the Notepad program. 


<F4> Quit 
5. Delete 
Page 4 File NOTEPAD 


Sat 27 Jan 1990 11:07:07 
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NOTEPAD program. Once typed in it will 
be usable for note entries, but very little 
else. Next month we will add a range of 
useful features to it, and discuss the 
various ways it can be used. This month 
we concentrate on the toolkit procedures. 

The listings are printed with all user- 
defined names in upper case, making for 
more readable code. The editor automati- 
cally translates Archive commands into 
lower case, so by leaving caps-lock on for 


Listing for Part One 


proc START 


all except string literals (text in quote 
marks), you will also spot mis-typed 
Archive statements, as they will remain in 
upper case. 

Enter the listings in the order printed 
(Archive will display them in alphabetical 
order). Many procedures rely on those 
developed earlier. As you type in each 
procedure you can test it and see how it 
works. This not only makes mistakes 
easier to detect, but also aids understand- 


- Notepad procedures 


let TODAY$=date(1)+" " 


ing. Do not enter the REMarks unless you 
really have got time and memory to spare. 
The first procedure, START, is a tem- 
porary one, for use only until next month. 
It initialises two global variables (although 
not with their final values), and attempts to 
run the NOTEPAD. Obviously this last 
stage will not work until the NOTEPAD 
procedure is typed in. Run it at least once 
at the start of any editing session, to 
Continued on Page 35 


let HEADING$=chr (15)+chr (20)+chr (0)+chr(0)+chr (80)+chr (25) 
mode 0,8: sload "NOTEPAD" 

error NOTEPAD 

error SHUT;""; mode 1,8 


proc WINDOW;WID,DEP,COL , ROW 


print chr(20)+chr(COL)+chr (ROW)+chr (COL4+WID)+chr (ROW+DEP) ; 
endproc 


proc SHUT;FNAME$ 


let CURRENTFILE$="" 
if FNAME$=""" 
while 1: close : endwhile 
else : Close FNAME$: endif 
endproc 


: rem CLOSE ALL OPEN FILES 
: rem OR JUST THE NAMED FILE 


proc CENPRINT;LINE ,MESS$ 


local COL: let COL=40-(len(MESS$)/2) : Tem FIND START COLUMN 
if COL<1: let COL=1: endif : rem CHECK IT'S NOT LESS THAN ONE 
print at LINE,O; ink 4;chr(27)+"A"; tab COL ;MESS$; 

endproc 


proc GETCHOICE ;MESS$,MAX, INIT$ 
local KEY$,ANS$,F$ 


let F$="BYTES :"+gen(memory (), 7) 

print HEADING$; at 24,10;F$; at 24,42; TODAY$;" ";time(); 
let F$="PRESS OPTION NUMBER OR INITIAL" 

CENPRINT;1,"<F5> Calc A <F4> Quit" 


: rem FIRST PRINT THE STATUS LINES 


CENPRINT 32 ,MESS$ : rem THEN DISPLAY THE PROMPTS 
let ANS$=INIT$+"'0123456789"(1 to MAX+1) 
while not instr (ANS$,KEY$) : rem LOOP FOR INPUT 
let KEY$=upper (inkey() ) : rem USE getkey() IF MULTITASKING 
if KEY$=chr(22): let F$=CURRENTFILE$: error CALCULATOR 
let CURRENTFILE$=F$: if F$<>"": use F$: endif 
GE TCHOICE ;MESS$,MAX,INIT$: return : endif 
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if KEY$=chr(21):CONFIRM;"Quit this prgram" 
if YES: error SHUT;""": mode 1,8: stop : endif 
GETCHOICE ;MESS$,MAX,INIT$: return : endif 
print at 24,60;time(); 
endwhile : rem END OF INPUT LOOP 
if instr(INIT$,KEY$): let ANSWER=instr( INIT$,KEY$)-1 
| else : let ANSWER=val (KEY$) : rem PUT RESULT IN ANSWERS 
endif 
CENPRINT3;1,str( ANSWER, 2,0) : rem DISPLAY RESPONSE 
endproc 


proc CONF IRM;MESS$ 
GETCHOICE s;MESS$+"? (1. Yes QO. No)",1, "NY" 
let YES=ANSWER 
endproc 


proc ALT ;NEWRECORD 
local T$,P: let P=recnum(): sprint : rem STORE recnum() 
if NEWRECORD: let T$="INSERT" : rem SET UP APPROPRIATE PROMPT 
else : let T$="ALTER": endif 
CENPRINT;1,T$+" : Press <Tab> or <Enter> for the next line." 
let T$="<SHIFT>+<TAB> back a line. " 
CENPRINT;2,T$+"<F5> completes. <ESC> quits without updating." 


alter : position P : Tem RESTORE POSITION AFTER ALTER 


proc GETSINPUT;DEF $ 
let ANSWER$=DEF $ 
sinput ANSWER$ 
endproc 


proc GETSTRING;QUEST$,DEF AULT$ 
let ANSWER$=DEF AULT$ 
WINDOW; 80,25,0,0 > rem SET UP PROMPT QUESTION 
print at 1,0; ink 4; tab 46-len(QUEST$) sQUEST$;" : "; 
error GETSINPUT;DEFAULT$ : rem ATTEMPT TO USE SINPUT 
if errnum() and errnum()<>27 : rem IF IT FAILS, USE INPUT 
. print chr(27)+"A"3: input ANSWER$ 


proc FOPEN;MESS$,LOG$ 
local LOOP: let LOOP=1 
if instr(MESS$,"File Is ")<>1 > rem SEE IF FILE IS GIVEN 
while LOOP ; rem IF NOT, ENTER INPUT LOOP 
GETSTRING s;MESS$+" ( ? for dir )",LOG$ 
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if ANSWER$="7" : rem IF DIRECTORY 
GETSTRING;"Directory for","" > rem GET DEVICE NAME 
WINDOW; 70,17,5,5: dir ANSWER$ ; rem & DISPLAY FILES 
else : let LOOP=0 : rem OR EXIT THE LOOP 
endif 


endwhile : rem END OF INPUT LOOP 
else : let ANSWER$=MESS$(9 to ): endif : rem OR FIND FILE NAME 
let YES=0: error SHUT;LOG$ : rem ENSURE FILE STARTS CLOSED 
open ANSWER$ logical LOG$ : rem ATTEMPT TO OPEN IT 
let YES=l: let CURRENTFILE$=LOG$ : rem THESE ARE SET IF SUCCESS 
endproc 


proc NOTEPAD 
local FILE$,OPTION,T$: let REDRAW=1 
let YES=0: while not YES : rem LOOP TO OBTAIN/CREATE FILE 
error FOPEN;"NOTEPAD -- Required file", "NOTEPAD" 
let FILE$=ANSWER$: if errnum()=100 : Tem CANNOT OPEN FILE 
CONF IRM;F ILE$+"' does not exist. Create new file" 
if YES: create ANSWER$ logical "NOTEPAD" 
PAGE: TITLES: N1$:N2$:N3$:N4$:N5$:N6$:N7$: NOH: NI$ 
N10$:N11$:N12$:N13$:N14$:N15$: N16$:N17$:N18$:NI19$ 
endcreate : append : let PAGE=l: append 
order PAGE;A 
endif : endif : endwhile : rem END OF OBTAIN FILE LOOP 
last :; let PAGETOT=PAGE : rem STORE HIGHEST PAGE NUMBER 
while 1 7 Tem ***#*##*#***** MATIN NOTEPAD MENU LOOP 
if REDRAW: window;80,25,0,0: screen : let REDRAW=0: endif 
let ANSWER$=""; print at 3,15; ink 2;"NOTEPAD/CARD INDEX" 
let T$="" File "+upper(FILE$)+chr(126)+chr (126) 
print at 3,40; ink 2;"Page ";PAGE;T$: sprint 
let T$="0. Exit 1. Find another page 2. Actions" 
GETCHOICE; T$+" 3. Text 4. Print 5. Delete",5,"EFATPD" 
let OPTION=ANSWER : rem RESPONSES TO SELECTION 
if OPTION=0: error SHUT;"NOTEPAD": return : endif 
if OPTION=1: error PAGEF IND: endif 
if OPTION=2: error PAGEACT: endif 
if OPTION=3: error ALT;0: endif 
if OPTION=4: error PAGETEMP: error PRINTOFF: endif 
if OPTION=5:CONFIRM;"Confirm - delete page "+str(page,2, 70) 
if YES: delete : endif : endif 
endwhile 2 Trem *#****#xHe END OF MAIN MENU LOOP 
endproc 


proc PAGEF IND 
local OPT?!9N,C,P,T$: let P=PAGE: let YES=1 
let T$z'G. Exit 1. Back 2. Next 3. Goto 4. Wordsearch" 
GETCHOICE;T$+" 5. Add new page 6. Contents",6,"EBNGWAC" 
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let OPTION=ANSWER: if REDRAW: screen : 


let REDRAW=0: endif 


if OPTION=] and PAGE>1: back : return : endif 
: rem ADD NEW PAGE IF THIS IS THE LAST PAGE 
if eof(): let OPTION=5: endif : endif 


if OPTION=2: next 


if OPTION=3 


GETSTRING;"Go to which page number? ",str(pagetot,2,0) 
locate val (ANSWER$) : rem CHECK NOT AT Ist, EMPTY PAGE 


if PAGE=0: next 


: endif : endif 


if OPTION=4:GETSTRING;"Search for which word(s)?","™" 
find ANSWER$: while found() and YES 
let P=PAGE: sprint :CONFIRM;"Continue searching" 


if YES: continue : endif 


endwhile 


if not found():CENPRINT;1,"NOT FOUND.": locate P: endif 

: rem GO BACK TO LAST PAGE FOUND 
: let PAGE=PAGETOT+1: append 
let PAGETOT=PAGE: screen : print at 3,45; ink 3;"Page ";PAGE 
error ALT;1: endif : rem CREATE PAGE, & THEN EDIT IT 


endif 


if OPTION=5: first 


if OPTION=6: first 


: next : 


if C=0:WINDOW;76,19,2,5: cls : endif 
print gen(PAGE,6);" - "s;TITLE$: next ; let C=C+1 
if C=21: let C=0:CONFIRM;"Continue Listing": endif 


endwhile : 
endproc 


ensure the variables are initialised. 
HEADING$ uses the screen driver to turn 
off the cursor, and give the full 80 x 25 
screen, whenever it is PRINTed. Much 
use of the screen driver will be made by 
our program. For a full description see, for 
example, Archive Secrets in QLW Octo- 
ber 1989. 

And so on to the toolkit procedures: we 
shall look at their purpose and use and, 
where applicable, ways they could be 
extended if so desired. (The parameters 
required are shown as numeric or string 
expressions, as in the User Guide.) 


WINDOW; <n.exp>, 
<n.exp>,<n.exp>,<n.exp> 


Makes the screen driver windowing facil- 
ity a little friendlier. The four parameters 
are the width and height of the window, 
and its column and line co-ordinates. It 
could be improved with some range 
checking, trimming excess lengths and 
widths to fit the screen. 


SHUT; <s.exp> 


Is one of the procedures which enable 
error trapping. It should always be used 
preceded by the ERROR statement. 
There are two modes of use: the first is to 
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supply a logical file name as the para- 
meter, which SHUT will attempt to close. If 
it was not open the error will be caught. 
The second is to provide an empty 
filename, which closes all open files. The 
WHILE loop continues to close files until 
all are closed. The error resulting from the 
next CLOSE statement returns control. 
This is useful, particularly when starting 
and ending a program, to ensure no stray 
files are left open. 

The global variable CURRENTFILE$ is 
also reset to empty. This is used to keep 
track of the logical file name of the file 
currently in use, enabling ‘on-line’ proce- 
dures, such as the calculator, to restore 
the file afterwards. Ideally, all the file 
commands should be both error trapped, 
and used to update CURRENTFILE$ in 
this way. However the desktop program 
almost entirely uses single files, so only 
closing and opening files are provided for 
in our toolkit. If required, similar proce- 
dures could be provided for USE, LOOK, 
and IMPORT. 


CENPRINT;<n.exp>,<s.exp> 


Is another quick and easy procedure. It 
prints a message in the centre of a line, 
requiring the line number, and the mes- 
sage as parameters. The start point for 


let C=0: while YES and not eof() 


locate P: let REDRAW=1:PAGEFIND: endif 


the message is calculated from its length. 
The line is cleared, ink set to green, and 
the message printed. It is mainly for use 
by other toolkit procedures, and helps 
provide neat and tidy prompts. 


GETCHOICE;<s.exp>,<n.exp>, 
<s.exp> : result in ANSWER 


Is one of the most important toolkit 
procedures, as it is the main point of 
interaction between the program and the 
user. It prints the prompts simply by 
sending a message (the first parameter) 
to CENPRINT, along with the ‘standard 
prompt’ line. The program then loops 
around waiting for a valid keyboard 
response. Valid responses are a number 
between 0 and the number of options (the 
second parameter); one of the initial 
letters of the options (which are passed as 
a string in the third parameter): or one of 
the built in functions. While it is looping, an 
on-screen clock is maintained on the 
bottom line, This is useful in reassuring 
the user that the program is (a) still 
running, and (b) waiting for a response. If, 
on the other hand, you are multi-tasking 
other jobs at the same time, this kind of 
manic looping is a good way of grinding 
everything else to a standstill. If that is 
likely, use a true multi-tasking clock, and 
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replace INKEY() with GETKEY(), giving 
other tasks full use of the processor until 
you get round to responding. 

in addition to the specified menu, 
GETCHOICE provides access to built-in 
functions. The idea is that these can be 
accessed from any normal menu. Two are 
to be provided — a rapid exit from the 
program, and a calculator. After calling 
one of these functions, GETCHOICE 
must be able to carry on with the original 
menu request. We will be looking at the 
programming issues involved in this when 
the calculator program is developed, but 
in the meantime identify the two examples 
of recursion — direct and indirect — 
employed. 
CONFIRM :<s.exp> : result in YES 
This is a customised use of GETCHOICE, 
for occasions when a YES or NO is 
required. It saves a bit of code, by adding 
the extra prompts and parameters, 
instead of having to add them each time. 
Mainly, though, it provides clearer source 
code, with the result put into the variable 
YES. This makes it very obvious what is 
being done, when CONFIRM is used. 


ALT;<n.exp> 


Is primarily provided to error trap the use 
of the ALTER command. It provides one 
of the few occasions when the ESC key 
can be safely used, in this case to 
abandon an edit. If Archive is not waiting 


ince its inception on 

the QL; the Psion 

quartet has 

appeared on a num- 
ber of other computers..in its 
more integrated form as 
Xchange, itis available for PC- 
compatibles, ICL -OPDs, ‘and 
QL derivatives, among others. 
For more limited. budgets there 
is. the ‘not-quite-integrated’ 
PC-Four package, for PC com- 
patibles. All of these contain 
the Archive program, more’ or 
less as found on your QL. More 
recently Psion's interest..has 
been elsewhere, and their soft- 
ware hag not kept up with the 
PC market, but if you have to 


the sake of ob progiees. A.num- 


ber of genuine enhancements 
were made, and also. several 
curious . omissions, 
the POSITION, RECNUM() 
and. MEMORY() commands. 
For. this reason you -will not 
easily be able to run a QL 
Archive program directly on a 


So what are the improve- 
ments made on PC. Archive? 
The first thing you will notice is 
the extraordinary increase in 
speed, Considering the QL 
and PC-XT run at similar.clock 
speeds, the difference is sur-. 
prising, and strongly suggest 


the database indices in files of 


for keyboard input, use of ESC causes the 
program to terminate, handy for de- 
bugging, but not much fun in normal use. 
Also the V2.0 ALTER bug, which can 
corrupt records, is trapped by restoring 
the record position afterwards. In addition 
ALT provides a set of prompts, suitably 
modified depending on whether the NEW- 
RECORD parameter is set or not. The 
INSERT command is not used by this 
program, due to the lack of control it gives. 
Instead, each application is responsible 
for adding its own new records. For 
example, with the notepad, the first file is 
an empty record. By going to this record, 
and using APPEND a new, blank record is 
created, which can then have its page 
number added, and be passed to ALT for 
editing. 
GETSINPUT;<s.exp=, : result in 
ANSWERS, or errnum() 
GETSTRING:<s.exp>,<s.exp>: result 
in ANSWERS 


These are used together, to provide a text 
response facility (what a Mac user might 
call a dialogue box). GETSINPUT is only 
likely to be used by GETSTRING, and 
simply provides error trapped access to 
SINPUT, a much more powerful com- 
mand than INPUT, as it allows editing of 
existing as well as new text. This means 
the program can offer a default response 
(GETSTRING'S second parameter), 
which can be accepted, replaced or 
edited, as required — just like in the other 
Psion programs. 


ARCHIVE — QL vs PC 


their own. This allows up to 
four ‘different orderings, plus 
one selection, to be held simul- 
taneously with.instant switch- 
ing between them: Another 
innovation is ‘identifier indirec- 
tion’. Anexample: will best 
explain this: the statements | 


notably 


Network: 


@ syrmbol. This allows much 
more flexibility in designing re- 
usable procedures.. On the 
Xchange version there is also 
record locking and other com- 

mands to facilitate use on a 


Other than these . differ- 


program a PC compatible: 


Unfortunately, to use SINPUT, there 
must be an active screen variable of the 
required name. In other words, you need 
to decide, when you SEDIT your screen, 
that you want to use SINPUT at a given 
place. If Archive can't find such a variable, 
SINPUT generates an error. Several 
linked strategies are suggested here to 
overcome this limitation. First, SINPUT is 
to use the standard global variable 
ANSWER$ to make its request. 
Secondly, any full screen design should 
incorporate the ANSWERS variable, 
starting at postion 1,50 inthe prompt area. 
GETSTRING can then fit the prompt (the 
first parameter) on the left hand side, to 
match. 

Whenever possible, application prog- 
rams should keep this screen active, in 
case it is needed. Finally, as a fall-back 
position, GETSTRING can check that 
GETSINPUT ran without error, and if 
necessary request normal INPUT 
instead, which provides an answer, but 
without a default option. 


FOPEN;:<s.exp>,<s.exp> : result in 
ANSWER$, CURRENTFILES and YES 
or errnum() 


The last of this month's toolkit procedures 
provides a number of useful facilities 
related to the opening of a file. The 
second parameter is the logical file name 
which will be given to any successfully 
opened file. It is also the default name 
offered if the user is to be consulted on 
which file to open. Under this scenario, 
the first parameter provides a 
prompt message, and the user 
can accept the default offered, 
enter another file name, or 
request to see a directory, by 
entering a question mark. In 
this case, the device is speci- 
fied, the directory shown in the 
data area, and the request 
made again, until a file name is 
given. 

The other mode of use is to 
exclude the user altogether. In 
this case, the first prompt 


PC, andthe otherway roundis LET X$='Y’ » LET @X$=25 | Should begin with the words 
almost _certaitt to fail ‘without will assign 25tothe variable Y- | “File 1s", followed by the 
Significant modification. being redirected via X$ by the | desired physical _ filename, 


again with the logical filename 
as the second parameter. This 
simply bypasses the user 
request section. In both cases, 
the physical filename is put into 
‘ANSWERG$, and the logical 
filename into CURRENT- 
FILES$. {f Archive cannot 


use’a PC as well as a QL,'the that Psion failed to optimise the . ences,» the two . language’| open the file, eg because it 
PC-FourorXchange programs QL ode. If you have afast PC-. implementations, like the] doesn't exist, an error will be 
may give you.an efficient way AT Archive hurtles along, giv. packages asa whole, aré very | generated, which should be 
‘of using your existing know- "ing much greater freedom and “much the same. PC-Four pro- | trapped, and YES will be false. 
ledge to best effect. scope for ambitious program- » vides a familiar environment | tis up to the calling procedure 

In producing the PC version ming. for QL users, anid PC.Archive | how to handle a failed attempt. 
of Archive, Psion decided to In the language itself the. offers and instantly available} The remainder of Listing 
sacrifice direct compatibility for biggest change is in holding way for a QL Archivist to | Two is the start of the note- 


pad program. Before typing 
this in you should produce the 
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loaded, by typing MODE1,8: 
WINDOW:80,25,0,0: SEDIT from the arc- 
hive prompt. The problem now is that, 
within SEDIT, you are writing in parts of 
the screen that Archive is also using for its 
prompts. It is not a problem for Archive, as 
the writing which appears to overwrite 
your screen at the top and bottom will not 
appear on the finished screen. It is only a 
problem for you, remembering what you 
have put underneath. 

Finally you can type in the first two 
procedures of the NOTEPAD application. 
Explanation of how to get the most from 
the notepad and its card index abilities, 
will be given next month. The NOTEPAD 
procedure is in two parts. First it attempts 
to open a file. If it cannot find the file 
named (as will happen the first time you 
run the program), it will offer to create a 
suitable file of that name for you. In this 
way you can create as many different 
notepad files as you require. The second 
half of this procdure is the main program 
loop, controlling the display, and menu 
options. The PAGEFIND procedure facili- 
tates finding existing page entries and 


ANSWERS. 


2LINE VARIABLE « COL 
(WHITE iNK} 


4 LINE OF RED TILDES (*") 


BLACK iNK, GREEN PAPER 


WHITE BORDER, WITH GREEN 
TEXT VARIABLES, 
'N1S' to "N19$' 
each a single line 


n.b, do not enter the 
variable names as text. but 
via F3 V 


Fig. 2: The Sedit screen needed to start Notebook. 


SEDIT screen shown in figure two. The 
annotations give additional guidance on 
what is intended for this screen. The vital 
point is to identify which parts are to be 
typed in directly, and which are to be 
entered as screen variables. This should 
present no problem to anyone familiar 
with SEDIT. On the other hand, many 


J LT 7 7 i) 7 ) fi i say 


users will not be aware that SEDIT can 
generate a screen for the full 80 x 25 area. 
Normally, even in MODE 0 the bottom two 
lines are reserved by the SEDIT program. 
However, if you resize the screen to its full 
proportions before calling SEDIT, the 
entire screen is available for use. This can 
be done, with the toolkit procedures 


adding new ones. 

The menu will also show options for 
printing and ‘actions’. Do not be tempted 
to select these yet, as an error will result. 
Next month we will be adding not just a 
flexible printing procedure, but facilities to 
sort and select pages; cut, insert and 
order lines; and more toolkit procedures. 
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OL SUPE 


OLKIT Il by Tony Tebby 


Over 118 Commands:— Full Screen Editor, Key Define Print 
Using, Last Line Recall, Altkey, Job Control, File Handling, 
Default Directories, Extended Network 

16k Eprom Cartridge Version............ 

Configurable Version on Microdrive 


MIRACLE SYSTEMS PROD 


OL Trump Card 768k (Toolkit ll etc) 
OK Disc Interface (inc Toolkitll} .... 
QL Centronics Printer Interface (@E 28,75d 
QLExpanderam 612K Thrucard @£ 99.99e 


QL HARDWARE 


Single 3.8" Disc Drive & (Own PSU @£103.50a 
3.5" OS/DD Discs — 10 off.. £€ 9.20c 
Dual 3.5" Disc Drive & (Own 
Q POWER REG. The only real solution to your OL overheating 
(switched mode power supply run cold} . 
OL Keyboard Membrane 
OEP Ill Advanced Eprom Programmer 
Care Eprom Cartridges each . 
ULA CHip ZX8301 


PRINTERS 


STARLC10 Mono .. 
STARLC10Colou 
CITIZEN SWIFT 24-pin Colour.. 


SOFTWARE 87 {State MDV or Disc) 


(@£251,85b 
(@E 99.82b 


TEXT 87 V.3,00 .. @E 60.00d 
FOUNTED 89... @£ 15.00c 
FOUNTEXT 88..... fa£ 25.00c 


TEXT 87/FOUNTED 89/FOUNTEXT BB, (@E 94.99b 
2488 PRINTER DRIVER .@E 16.00 
Upgrade to Text 87 V.3.00, Return old copy together 
ren ee ee ee ete (@£25.00c 


MONITORS (Price including lead) 


Philips BM7522 Amber Hi-Res ...... 
Philips CM8833 Colour Med-Res .. 
Philips AV7300 TV/tuner for above .. 
Philips M7502 Green Hi-Res 


HOW TO ORDER: ALL PRICES INCLUDE VAT 


By Post. Enclose yout Cheque/PO made payable to CARE Electronics. 
Or use ACCESS/VISA. Allow 7 days for delivery 


..- @E 97.75a 
(-£253.00a 
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TONY TEBBY SOFTWARE (QJUMP) 


OFLP (Micro/P disc interface uParaeet « @£ 14.950 


QMON II science de, Oe 
QPTR Pointer Interface midrive wigs bind ebtinirecnreeensaraticnnaetl k. GRACO 
QOPTR Pointer Interface + 3.$° dise ..-....-... rise .@£ 29.900 
QTYP Type/Spell Checker .-@£ 29.900 


ZITASOFT SOFTWARE by Steve Jones 


LOCKSMITHE copies M/DRIVE — M/DRIVE .............. @£ 14.95¢ 
4MATTER + LOCKSMITH copies M/DRIVE — DISC .. @£ 23.00c 
The above programs are not for use in the UK. 
SHRIVEL memory shrink prog user definable ie 128k or 192k or 
266k ete ...........-- A -@£ 13.80c 
TOOLCHEST utilities to ‘allow the creation of ‘customised mdvy 
doctor prog w£ 14.96¢ 


SIDEWINDER — High resolution printer driver prints full 
screens or parts of screens from postage stamp size to large 
banners. Prints sideways, invert, scale, mirror, text insertion... 
(2£ 19.95¢ 

SIDEWINDER PLUS - (for expanded QL's) includes al! the 
features of above, PLUS multiple label printing, desktop 
publishing files and printer driver for 24’ pin plus LC10 and 3 
80 colour printers. (Please state 3.5" disc or M/D).... @£ 23,00c 
Upgrade to Sidewinder Plus ...........ccsccsecccieee @£ 8.05c 


HEAT TRANSFER RIBBONS & PENS 


Print your own T-shirt Design, Colour ar black and white. Please 
phone for further details. 


Star LC10 NX 1000, Rainbow £ 19:55¢ 
Star LC10 NX 1000, Black stimeagenl “TeBOc 
Okidata ML80/Epson FX/MXB0/Epson l X80 Black... Hietmak Woe 
Citizen 1200, Black ......... ¢ f 12.65c 
Epson FX100, Black .... ea Bias dean iaebisies wet, THese 
Jumbo 5 Colour Pen Set .... iinet WEE 
Small 5 colour penset- LOIRE ee £13.80c 
READYMADE LEADS 
AGB OLtoPhono .,, me §.75¢ 
RGB 8-6 pin DIN .. @e F.13¢ 
RGB 8-7 pin DIN (Hitachi} @eE 71k 
RGB 8-7 pin DIN (Ferguson) .... @£ 7.136 
RGB 8 pinto SCART (Euro} - fe 11,50 
6-way PCC 25-way ‘D' (Printer- Seri}. sivas @E 9.89¢ 


QPAC | Desktop accessories. Calen- 
dar, alarm, calculator, typewriter, 
digital clock, Sysmon ......@£ 21,85d 
OPAC II Main menu windows adjust 
automatically to size. Files, directory, 
view, print, delete, backup, jobs, 
pick, Rjob, sort, channels, things, 
exec, wake, buttons, Hotkey, Hot- 
jobs. Fully multitasking, allows 
many programs to run at once 

Requires min of 256k expanded 
TRENTON Y seveiinteecqanicacenavesey fe 49.91b 
Upgrade ORAM to OPAC II return 
MASHED icine @E 29.90b 


800 ST ALBANS ROAD, 
GARSTON, WATFORD, 
HERTS, WD2 6NL. 
Tel: 0923-672102 
Fax: 0923-662304 


Please add carriage 
a=£11.50 b=3.45 
c=£1.38 d=£2.30 


SD 4 4 4 a a ae ae ea / 


et FTWARE FILE 


MS-QLINK 


e do not often 


review prog- 
rams written 
outside the 


U.K., because we do not have 
many programs submitted 
from other countries. There 
are active users in several coun- 
tries. perhaps the most well- 
known to us being those in 
Germany. Portugal is not the 
first country to spring to mind 
as a home of OL. programmers 
but we receive fairly regular 
letters from a small band of OL 
devotees there, 

One of our correspondents 
there is Tiago Frictas Leal and 
he uses both QL and PC. 
Presumably for his own use 
initially, he wrote a file transfer 
program for those computers. 
He has also written a copy 
utility, Discopy, but that is 
commented on only bricfly 
here because Leal indicated 
that the program was not com- 
plete at the time he sent a copy 
towards the end of 1989. It is 
assumed that it will have been 
completed by now. 

There are already file trans- 
fer utilities for PC-QL work- 
ing. the obvious ones being 
DiscOver/MulttiDiscOver and 
XOver. MS.QLink is appreci- 
ably cheaper than both; the 
DiscOver variants cost £29.50 
and £39 respectively and 
XOver is only part of the 
Solution or Conqueror emula- 
tor packages, which cost con- 
siderably more. As a sampler, 
a publie domain version of MS- 
Qkinkis available tor£1 plus a 
blank disc on which ét can “be 
copied. The only functions pro- 


IMPORTANT 
Certain points criticised. in 
this: review. have been up- 


dated promptly by the pub- 
lisher. A list appeared in 
OL Scene, May 1990. 


several years to develop. 


INFORMATION 


Program: MS-QLink 1.0 
Discopy 1,0 


Price: MS-QLink £12, MS- 
QLink PD £lyplus dise, 
Discopy £7, MS-QLink 
plus Discopy £17 


Supplier; Ofile, Apartado 
2110, 1103-Lisboa Codex, 
Portugal. 


Payment by U.K. sterling 
cheque made Out to TF. 
Leal. Specify $.23in of 
3.5in dise, single- or 
double-sided. 


vided in this version are Direc- 
tory and View To Screen, for 
MS-DOS and QOdos. 
Instructions on the full ver- 
sion are in the form of Quill 
—DOC files, and are extensive 
more than 6,000 words. 
Apart from odd lapses. the 
author’s English is commend- 
ably good; the instruetions 
gencrally can be assimilated 
rather more easily than some 
English-written instructions J 
have encountered. This is nota 
load-and-go utility; you need 
to do some. reading first. The 
standards 360KB 5.25in and 
720K B, 3.5in disc drives are 
supported andthe same opefa- 
tions ean be performed.on both 
MS-DOS and Qdos dise¢s. 
MS-DOS sub-directories are 
not supported, but users who 
do not*have hard disc drives 
will presumably not be unduly 
interested in sub-directories. 
The program will not work 
with OL interfaces which do 


not permit direct disc sector 
addressing and the author sug- 
gests it may be necessary to 
upgrade the interface eprom 
— contact Care Electronics — if 
you have an early Micro 
Peripherals or Medic interface. 
The program can be supplicd 
on 5.25in or 3.5in disc. 

MS-QLink uses a run-time 
Turbo Toolkit to provide the 
necessary extensions to Super- 
Basic. It also has a_ small 
routine which can be used if 
your Qdos rom is earlier than 
JS. The program can be started 
by cither EXEC__W or EXEC 
and will multi-task with other 
programs. The command line 
editor works in the Insert mode 
for both Qdos and MS-DOS, 
No doubt that will appeal to 
many DOS users who have to 
suffer the deletion of every- 
thing they have typed when the 
cursor is moved left to add or 
change characters. 

Commands and parameters 
have to be separated by “onc 
space, as With MS-DOS. Char- 
acters in the code range 32 to 
191 are accepted, plus F3/F4/ 
ESC, left/right arrows and 
CTRL-+ left/right arrows;. the 
extra keys ate for command 
line -cditing.. The commands 
have been reduced to one letter 
for MS-DOS; for.Odos the 
same Ictters are used but with a 
~Q” in front of them, 

All Qdos devices are sup- 
ported — mdv. ram, flp, win} n6 
mention is made of fdk. Only 
floppies are supported with 
MS-DOS. The working device 
can be changed easily by typing 
the new device name, as is 
normal with MS-DOS. Wild 
card entrics in commands are 


Bryan Davies reviews a moderately priced, effective 
file transfer program from Portugal, which has taken 


supported; parameters are 
entered as with Odos, accord- 
ing to the conventions given in 
the OL User Guide. A useful 
feature is that all wild card 
commands can be interrupted 
by pressing ESC. Where 
choices need to be made the 
standard Y/N/A/Q” (Yes/No? 
All/Quit) conventién’ is/used, 
as in Toolkit I: 

As with XOver and Disc- 
Over, MS-DOSste-Qdos 
transfers include the appropri- 
ate. change to the -format;: 
period is changed to under- 
score and vice versav Ifa QL 
file name is. longer than the 
MS-DOS hmit of eight charac- 
ters. before».the period and 
three after it, “surplus” charac- 
ters will be removed during 
conversion. 

When the programs booted 
it loads the rtinetime, Turbo 
Toalkit, which «checks. the 
Odos version of the OL. If that 
is not JS a window appears, 
holding a message explaining 
that SB commands-ean become 
duplicated and eause problems 
when they are called and you 


are offered the chance t@“zap””.. 


duplicates..In the case of my 
system, two of the Turbo com- 
mands which are in the boot 
were branded»““bad. name” 
tinless the Turbos: TK._code 
extensions file had been loaded 
previously; presumably the 
author did not have this prob- 
lem but some other users 
might, 

Choosing ~Y~ once the boot 
was loaded resulted in several 
screensfull of duplicates being 
listed as zapped, because the 
Turbo__TK__code and run- 
time Turbo extensions files 
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have some commands in com- 
mon. Assuming this function 
works fully and safely it is most 
welcome, 
The system free memory fell 
by about S8SKB" and,a short, 


command sfile: W auto- 
matically. ehanging, the” 


“QDOS deice™ to RAMI_& 


able space is nevertheless 
detected correctly. 

In the extreme case you can 
get a <0 files> message when 
the. disc has dozens of files on 
it, There are other oddities, 

suchas: being told there is no 
“Volutie ‘Label on a disc when 
clearly sit’ has one and the® 


but only if a. RAM- distitScility, Yavailable Mdisc space being © 


if already in’ the QL = and 


Somewhat different front that 


, changing the printcr name to » quoted, on the PC: the latter? 


PAR if a patallel port exists. 
ented with a 

com mand line prompt looking | 
very like that.of MS-DOS -- 

B./>. PressingsF4 clears the 

__ $cecn, leaving just the com- 
" mand dine, F3. writes a list of 
available commands to the 

~y screen, on two lines, In typical 
-eutrent. PC’ menu» fashion, 

pressing a single fetter <Ushally 

the first = of the command 

name “and then pressing: 


ENTER. ractivates | that com- 


mand. 

The start-up tet 1% BS 
(floppy 2) and initial attempts 
to get Qdos or MS-DOS diree- 
tories from that drive were 
unsuccessful, Trying to change 
it to A: and C: resultéd dn a 
crash, a rarc occurrenceon my 
system thesc days. Re-loading 
was unsueccesstul ast stopped 
after. the surplus extensions 
had been zapped but a second 
try was sucvessful. The change 
to drive A: this time was satis- 
factory and a directory was 
obtained of a disc taken from a 
PC, in floppy 1. The instruc- 
tions say that drives A; to D: 
are supported and there was no 
difficulty when any of these 
drives was requested subse- 
quently, Likewise there were 
no subsequent problems 
obtaining either Qdos or MS- 
DOS directories from cither 
drive. 


Display 


If the disc contains any sub- 
directorics the program docs 
not give details of them but it 
will display files in the root 
directory. When there are no 
root files the presence of sub- 
directories produces the mes- 
sage <Unsupported disc>. 
There was some uncertainty 
about what was on the disc 
used for checking, as only one 
of nine files copied to it on the 
PC was identified when a direc- 
tory was done with MS-OLink. 
The impression given was that 
files with some extensions are 
not recognised but the avail- 
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_may be a function of the PC. 
“program, used for checking. 


_ Space, giving only the actual 
usable Space, The file sizes 
“giv efi Were,inagrcement, 


Se 


es. 


ut ‘ Lopndh 


Considering the MS-DOS 
functions first, the Format 
command <F> works well and 
has the useful option of doing 

ither a full format or just 
deleting the Directory entries 
for all files. The latter method 
is usually sufficient, a complete 
format really being required 
only when a disc is new — 
unformatted. The quick format 
takes less than 10 seconds, 
which will please most users. 
The full format takes about the 
same time as you would expect 
with Qdos or MS-DOS; 40- and 
80-track drives are allowed for. 

For example, <F A: 8> will 
perform an MS-DOS or quick 
format on the disc in drive A: 
(floppy 1), treating it as 80- 
track. With the proviso that 
files not recognised in the 
directory operation are not 
recognised by the other func- 
uons either, Directory/Wide — 
several files displayed on one 
linc - Erase, reName and View 
work well, Operations are 
generally fairly fast; in case any 
reader suspects it there is not 
the delay associated with using 
an emulator. Problems are 
generally indicated by sensible 
MS-DOS-like error messages. 

The Qdos commands are 
basically the same as the MS- 
DOS ones, with relatively 
minor differences for most 
users. The format is only the 
full type. File names up to 36 
characters long can be dis- 
played. When files are viewed. 
character codes are not trans- 
lated, as they may be with MS- 
DOS tiles, there being no need 
to avoid potentially-disruptive 
codes when the QL isin “native 
mode”. 

The Wide directory does not 
operate, because most of the 
screen width is occupied by the 


information on single files — 
size, type byte, dateof record. 
ing. file name. ‘Although most 
files ons the test disc wert 
noted snincsout of 25 Were not 
there andithere was sno obvious 
pointer from the file names to 
the difficulty, Again, the avail. 
able’ space on the disc. as. 
-cOrrect. 

Several commands allow 
output to be re-directed to a 


_ printer, The irritating inconsis- 
tency found With some prog- 


rams, ~where 
responscs are 


single-key 
sometimes 


ateepted directly and some- 
times need to be followed by 


ENTER, is absent from MS- 
QLink — a very refreshing fea- 
ture. The <Silent> command 
effectively switches other com- 
mands from being foreground, 
question-and-response types, 
to background, get-on-with-it 
ones. 

When the Silent status is <S 
I> you are not shown file 
names and not asked whether 
or not you want to over-write 
existing files and the invoked 
command — e.g., Erase — assu- 
mes you want all files to be 
dealt with in the same way. 
That prevents the MS-QLink 
activities writing to the screen 
and messing the displays of 
other jobs. In operations 
where user intervention is 
essential — e.g., Format, or 
when the <Retry or Quit?> 
message occurs — the screen 
will be used. It 1s indicated that 
the Silent mode is needed with 
QRam, which attempts to 
exert control over all screen- 
writing activities by uscr prog- 
rams. 

To some extent the use of 
devices is confusing. On a 
system which has a RAM disc 
routine present and two floppy 
drives. the default selections 
are floppy 2(B:) and RAMI__ 
The latter is acceptable for 
Qdos but initially I could use 
only floppy 1 (A:) for MS-DOS 
operations; later, both drives 
were used without difficulty. 
You can put a 3.5in dise in 
either floppy | or 2 and give it a 
Qdos format but floppy 1 gave 
a 720KB format and floppy 2 
gave 360KB, confirming the 
impression that a 5.25in drive is 
expected for floppy 2. 

In any event, you can alter 
the default devices at boot-up 
time by changing the assign- 
ments in the short boot file and 
they can be re-assigned during 
operation by typing the new 
device name. When ram1_ is 


: sperwegy ARPS and gee 


the default and the, curso 

prompt is curently Av >, ty P 
‘ing: »<{lp2_sEater>° will 
change . default Odos device. 
to floppy 2. This'is presumably 
how most users would want it 
to be, go that files can be copies, 


pes Lt 

c author ha§ tried to Cater 
for whatever possible system 
configurations the users might 
have; there might be some 
initial confusion but, once the 
desired devices have been sct, 
there should be little difficulty 
subsequently. In practice, the 
ability to handle both MS-DOS 
and Qdos devices from the 
same command line by using 
one-letter commands, or their 
equivalents with a “q™ in front, 
is very helpful. The Last Line 
Recall feature of the QJump 
Toolkit still works. 

The Read and Write com- 
mands deserve more descrip- 
tion, as they allow the usc of 
translation files. Command 
files also are important in 
reducing the need for repeti- 
tive keying. Command and 
translation files extend the 
basic functionality of the prog- 
ram considerably. Systems 
with cither Turbo__TK__code 
or Super Toolkit II installed 
can be set to call these files 
from other devices, rather than 
the default flp1. 


Transferred 


The Read command <R> 
enables an MS-DOS file to be 
transferred from an MS-DOS 
disc to a Qdos device and 
converted to the Qdos format 
in the process. The Write com- 
mand <W> accomplishes the 
reverse process, Qdos to MS- 
DOS. When the program is 
started it attempts to load a 
default (Qdos) translate file. 
As files can be created using a 
supplied SB program it is for 
the user to create a suitable file 
or files of his requirements. 
While the familiar keyboard 
characters can be passed either 
way between PC and OL. with- 
out difficulty, control codes 
and some displayable charac+ 
ters are used differently: for 
this reason, the translate oper-, 
ation is split into two sections, 
one handling keyboard codes 
32 to 126 and the other control 
codes 0 to 31 and 127. 

There is also the matter of 
how lines are terminated and 
the New Line code is set auto- 
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matically as one or two CR LF 
(carriage return/line feed) 
pairs, as appropriate. Other 
control codes are changed to 
Spaces. The same translate file 
can contain entrics for both 
Read and Write operations, 
the form being very simple: 
<hmmr> would convert inst- 
ances of “h” into “*m™, and “m" 
into “r™. 


Success 


Files were passed success- 
fully between text’ and The 
Editor on the OL and Word- 
Perfect 5.0 on an AT, The only 
hitch was a consequence of the 
automatic filename conversion 
function, which changed the 
extension <.WP> to 
<__WP> correctly but added 
a space on the end, presumably 
on the assumption that all 
extensions have three charac- 
ters in them. The Space is 
supported by MS-OLink as a 
valid character, which could be 
a useful function; in this case 
the space was not evident until 
it was located using the View 
function of /ee. The transferred 
files loaded correctly in their 
new homes. 


Command files take some of 
the drudgery from repeated 
operations. They can be cre- 
ated using Quill. Apart from 
the normal commands men- 
tioned, a command file can 
contain Echo, Wait and Beep, 
which respectively display a 
string on the screen, display a 
string and wait until you press 
any key, and display a string 
and beep continuously until 
any key is pressed. Obvious 
uses of command files are to 
change defaults and name 
regularly-used files for Read or 
Write operations. 

As the Atari ST disc format 
is based on the MS-DOS for- 
mat you can make transfers 
between ST and OL, provided 
the Atari drive is double-sided 
and both QL and ST drives 
have the same number of 
tracks (40 or 80). 

The Discopy program is an 
EXECutable background task 
for copying — not converting — 
whole MS-DOS, Atari TOS or 
Qdos discs. The version sup- 
plicd worked with Qdos discs 
but halted when presented with 
MS-DOS discs. As indicated 
by the author, the program as 


supplicd on the review disc was 
not ready for distribution but it 
may have been completed 
now. Complete dises in either 
format can be copied with MS- 
QLink and that would seem a 
better buy for the extra few 
pounds but copying in the same 
format is slower because of the 
need to copy from disc to RAM 
and back to disc, changing the 
default disc drive in-between. 

Programs from relatively- 
unknown sources tend to put 
me in a somewhat negative 
frame of mind from the start, as 
I wonder how many things will 
go wrong in the review period, 
This is not to say that programs 
from the better-known sources 
are trouble-free — they rarely 
are — but the programmer with 
less experience can easily over- 
look common difficulties which 
undoubtedly will occur once a 
program gets into the hands of 
ordinary users. 

The lengthy process of com- 
bining all the instruction files 
and reducing the length of the 
paper output gave me time to 
consider the words before 
pressing the keys and the 
impression gained from the 


instructions was all favourable. 
It was only when the program 


was first run that doubts 
appeared. 
There are some weaknesses 


in the program structure and it 
takes a fair amount of time to 
get to grips with the way 
devices are handled but the 
overall impression ts that this is 
not another cheap and insigni- 
ficant amateur program, There 
are real, useful — and usable — 
functions in it which are suit- 
able for the user who has both 
PC and OL and needs to 
transfer files between them but 
does not want to spend much 
money. 

The low price in no way 
indicates low quality. As the 
program has been developed 
over several years it is likely 
that improvements have been 
made since the review copy was 
despatched but the experi- 
enced OL user might not find 
the flaws in the tested version 
big enough to cause undue 
difficulty. Even so, it is sug- 
gested that potential buyers 
ask first if the problem of 
recognising certain file types 
has now been rectified. 


Stone Street, North Stanford, Ashford, = 
TALENTS fis == ROE 
Tel:0303 813883 Fax: 0303 812892 Telex: 966676 PMFAB G EUROCA RD 


Identify 500+ stars and planets with 
this impressive astronomy program. 
COSMOS displays accurate star maps 
for any date and time anywhere 

in the world, View the solar 

system, the moons of 

Jupiter, Saturn's rings 

- any visible object in 

the sky 


CARTRIDGE 
DOCTOR 


Essential for all QL owners. 

#% Rescue files from damaged 
cartridges 

#* Recover newly deleted files 

#* Recover files with damaged 
blocks 

a And much more 


ASSEMBLER 
WORKBENCH 


A complete set of tools for the 
machine code programmer. 
Combines assembler, monitor and 
screen editor. Dual screen to assist 
debugging of graphics programs, 
can operate on RAM or disc files. 
Compact and easy to use. 


A two-dimensional CAD package 
suitable for all general, scientific 
and engineering applications 
Create accurate, finely detailed 
plans, diagrams or designs. 

# Zoom in and out. 

# Library of drawing tools 

# Fast, multi-width output 

% 2 screen modes 


Basic-ally 
Jungle Eddi 
GraphiQL+ 
Horrorday 
Hoverzone 
The Prawn 


Please telephone for details of products of 288 Software 
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PIPING 
HOT 


by Bill Currie 


P-RO-GS 


If you have a program worthy of consideration, send it to The Progs’. 
Sinclair Q Greencoat House, Francis Street, London SW1P 10G. 
We pay for everything published at the usual page rates. 


‘Piping Hot’ was developed out 
of a need to use a CLEAR 
instruction while retaining cer- 
tain subsidiary routines (for 
example, for OLink, for which 
refer to Simon Goodwin’s arti- 
cle in QL World, October 
1988). Difficulty had been 
experienced in the repeated 
use of Odos aRIthmetic routi- 
nes in developing a program on 
the Mandelbrot set, and it was 
found that intermittent use of 
the CLEAR instruction helped 
to over come these. 

Once opened, two pipes can 
be easily joined, using the 
procedure j(chana,chanb) in a 
couple of lines of program- 
ming. Information may then be 


MM RR RA 


ae 


FLow to move data from the 
firsttothesecondpipe—not that if the program — is 
automatic LOADed, typing, for exam- | 

Hex converter ple, ‘c 1° will cause a printout of 

Channel definition data and The second part of the prog- channel definition data. It is 


WINdows for 80 
width 


character Readers may like to note 


PRINTed to chana, a CLEAR 
instruction issued and the 
information retrieved ~— by 
INPUT to chanb. 

The program is in two parts: 
the first part is a series of 
utilities. These are: 


pipe contents 
Link (two way ‘END to END’) 
Join (one way only) 
Separation of pipes 
iT$emise contents of a pipe 
Remaining useable iTT$ems in 
a pipe 


ram is a straightforward game/ 
experimentor to illustrate pos- 
sible uses of pipes, for instance 
in sort routines as well as with 
CLEAR instructions. If the 
program is run it will go 
straight into the game. 


almost as if cach independent 
procedure were a_ separate 
program. This idea can be very 
usefully developed, particu- 
larly with short (for example, 
one-letter) procedure names. 
Continued on Page 44 
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Lo. bink: $s ue edd 


1570. AT oa? PRINT a 
BSE Oo. COT PE OPS." 9 "0, 
2990-0VER » 6 


2620" may Sgt wpanteniods f26:PAPERRIS? Sects 
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BAGO oe Oe. : 
3460 IF. dies=’d*. THEN. inc=0 
S470 témperature=bemperature+ine 


3490. IF “spec$==" bh? THEN temp érature*température ti 


» 8490-AT°2,SP. PRINT temperature! ! 
) 3500 IF. bewperature> loo. THEN.GO*TO° S550 


© 3510 AP, di s$=" 0”. AND. t£$¢0) 1 =? Pf? AND. ££6 O37 2>=7 2. AND teed, 39%% a”. AND tts Ca, aa ” 
2 AND £t$03/59=75", THEN, marker =P: G0 TO° 9540 


3520 END REPeat loping 
. Soaso : 


3540. IF marker=bk THEN: CLS: CLS#O:2 PRINT 3S’ © CONGRATULATIONS Yau’.ion’ 2.80 “TO. 3560 
S5S0c CLS CLS#O:PRINT: sy? overheat2. rig? aN" you © Lost? 


S560 “tune 


3570. PRINT AS? prés= 4. for another go’. er “s +6 stop’ 


S580» #$INKEYS%-4) 

3390 °LF= atee gy’ THEN @ game 
3600. Th ade hs*. THER. STUP 
S610 GO-TO 8586 

3629 = 
36350 END DEF ine 

B64 

3650 END DEF ine 

3660 : 
3670 DEFine.PROCedare tune 
368%. RESTORE 

S690 TIM acaos 


SOO RPOINTORND OF) eFOR ke Py TO°49t READ atko PBEEP 995.00 vat) vat k2-RP2O00, 4595.0.02 7 
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The Independent OL User Group 


The Definitive Guide 
To SuperBASIC by Jan Jones 


This highly sought-after book has 
been reprinted by QUANTA. 
Copies are now available for £8 plus 
£2 p&p from: 


QUANTA 


62 CROSSPECT AVENUE 
RUSHDEN 
NORTHANTS 
NN10 SDH 
Tel 0933 410277 (answerphone) 


Subscription to our group is still £14 UK, 
and £17 for overseas members. 


Now in our SIXTH successful year. 
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Ms® advertisements are legal, decent, 
honest and truthful. A few are not, 
and, like you, we want them stopped. 

If you would like to know more about 
how to make complaints, please send for 
our booklet: ‘The Do’s and Don'ts of 
Complaining’. It’s free. 


The Advertising Standards Authority. 
We're here to put it right. 


ASA Ltd., Dept. Z, Brook House. Torrington Place, London WCIE 7HN. 
This space is donated in the interests of high standards of advertising. 
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P D OL Computer Systems and Software 


UNIT 1, HEATONHOUSE CAMDENSTREET BIRMINGHAM B13BZ 021 2002313 


MAKE THE MOST OF YOUR QL AND THOR 


for home and business use — Order from list or write for current catalogue. Prices include VAT and postage within the 
UK. Cheques with orders to, and full descriptive list available from PDQL. Please state details of toolkit, extended 
memory and or disc. 


SPRING INTO ACTION 
WITH PDQ SOFTWARE 


BUSINESS PROGRAMS: 
PDQ-Payroll 


UTILITY PACKAGE 


COMPARE - the easy way to detect differences (even an extra 
space) in two files supposedly the same. Contains the famous 
magic sliding panel. Suitable for any text/system/SuperBASIC file 
- easy to use alignment/reposition options - ignore first n columns 
(e.g. line numbers) 


Trading Accounts (inc. Analyser) 
The complete accounting system 


Cash Trader Upgrade 
(For use with sub 33 sales and purchase ledger 
accounts) 


PDQ-COPY - not merely a fast copier. You can obtain a complete 
(or exceptions only) listing of files on different media (e.g. disc or 
cartridge), copy dates, sizes. You can copy all, by Yes/No input, 
by up to three strings e.g, all_doc files beginning PDQL, optional 
pause before overwriting, format destination disc/cartridge or 
delete files; set it up, pour your coffee, and PDQ-COPY has 
finished its task. 


Analyser 
Mailmerge de Luxe 


TexTIDY - tidies up your _doc files by converting to plain text; OR 
to Wordstar or DOS Quill format prior to using DiscOVER; converts 
from DiscOVERed DOS Quill to QL Quill format; tidies Disc- 
OVERed Wordstar or other text files priorto importing into EDITOR 
or importing into Quill. In addition you can import into Quill your 
SuperBASIC program, edit, save, TexTIDY and BINGO! run or 
compile the TexTIDied file. 


IMPROVE YOUR ARCHIVE 
PDAQL is offering a special ARCHIVE package - 


ARCHIVE TUTOR - which teaches you what you didn't 


know about Archive All three for £25 (You can still buy them separately!) 


SEDIT - the sensible way to build your Archive screen 


UNIT 1, HEATON HOUSE 
CAMDEN STREET 
BIRMINGHAM B11 3BZ 
021 200 2313 


RECOVER - the essential insurance program to cope 
with lost database files 


2 


All three for £45 (You can still buy them separately!) VISA 


Your ticket to DiscOVER 


DiscOVER is the essential program for transferring any 


file EITHER WAY between QL and |BM format. NO 

. QL to IBM RETURN CABLES NEEDED. NOSIDE-by-SIDE MACHINES. Run 
DiscOVER, select to or from the QL, transfer all or cursor 

selected files. Features include optional symbol trans- 

FIRST Any Day late; delete file; automatic filename change for IBM/QL 


CLASS £29 50 compatibility. Available on 3.5 or 5.25 disc 


PDQL have a larger version including CPM and BBC 
transfer facilities as weil as IBM - Multi-DiscOVER 


£39.00 


European orders may be placed with: 
DANSOFT, Raadhusstraede 4B1, 1466 Copenhagen K, Denmark. Tel 45(01) 930347 11. 


